home *** CD-ROM | disk | FTP | other *** search
/ Computer Shopper 228 / DPCS0207.ISO / Extras / RoboTask / RobotaskSetup.exe / {app} / robotask.chm / cshelp.txt < prev    next >
Encoding:
Text File  |  2006-07-14  |  157.0 KB  |  4,960 lines
  1. .topic 1
  2.  
  3. RoboTask can easily automate any series of tasks on your computer system, whether you are a novice or advanced  user. You don't even have to know how to programùuse RoboTask to build your own automated solutions quickly and easily. Yet RoboTask is powerful.
  4.  
  5. For example, RoboTask can help you avoid losing important data when you create a backup task for placing files on a remote server.
  6.  
  7. The software can manage and trigger a wide variety of repetitive tasks to save your valuable time. With RoboTask, you don't need complicated batch files or scripts.
  8.  
  9. Here are many examples of what RoboTask can do for you:
  10.  
  11. Runs applications and open documents.
  12. Manages automatic backups.
  13. Alerts you of any changes in your folders.
  14. Shuts down Windows and powers off your computer triggered by any event you choose.
  15. Processes files and folders (copies, moves, renames, deletes).
  16. Works with FTP and Web servers (downloads, uploads, etc).
  17. Sends letters and files by e-mail.
  18. Starts and stops Windows NT services.
  19. Sends network messages as WinPopups.
  20. Acts as an alarm clock.
  21. Much more!
  22.  
  23. RoboTask can be used for an unlimited number of tasks. When creating a task, you decide what the task needs to do and when. Every task has two parts:
  24. 1.    Actions
  25. 2.    Triggering events
  26.  
  27. Actions
  28.  
  29. First, you must decide what actions you want to accomplish. You can select built-in actions in RoboTask to accomplish the following:
  30. Run applications.
  31. Open or print documents.
  32. Emulate your keystrokes.
  33. File and folder processing (copy, move, delete, rename, synchronize folders).
  34. Work with FTP servers (download, upload, rename, delete).
  35. Work with e-mail (check for e-mail, send e-mail).
  36. Work with ZIP files (pack files, extract files).
  37. Work with windows (focus, maximize, minimize, restore, close, hide, unhide).
  38. Flow control (if-then, file loop, text loop, dataset loop, and so forth).
  39.  
  40. Triggering events
  41.  
  42. A triggering event can be one of the following:
  43. A specific time
  44. When something happens on your computer.
  45.  
  46. Practically anything that happens on your computer can trigger RoboTask to perform an action. An example would be when RoboTask automatically updates a log and uploads it to a website whenever you receive an email with a subject that is a particular string of words or contains a word such as "Important".
  47.  
  48. The following are examples of triggering events:
  49. Scheduler (at a specified time).
  50. Hot Keys (when a special key is pressed).
  51. Tray Icon (when you double-click it).
  52. File Monitor (when a particular file is created, destroyed, changed, renamed).
  53. Dial-up Connection Monitor (when a connection is made or broken).
  54. Window Watcher (when a window is created, activated, closed, and so forth).
  55. System Events (time, spooler, device, display changed, log on, log off, on idle).
  56.  
  57.   Related Topics
  58. Getting Started in the RoboTask Window    
  59. Create Tasks
  60. Run Tasks    
  61. Edit Tasks    
  62. Customize RoboTask
  63.  
  64. .topic 740
  65.  
  66. The following information introduces you to the RoboTask main window.
  67.  
  68.  
  69. To learn about the RoboTask window, click buttons or other items, such as the panes, in the following picture.
  70.  
  71.  
  72.  
  73. Shortcut Menus
  74.  
  75. If you select a task in the Task Name column and right-click, the following commands appear on the shortcut menu:
  76. Enabled - Allows the task to start automatically when a triggering event in the task occurs.
  77. New -  Creates a new task.
  78. Edit - Modifies the task that you select.
  79. Delete - Removes a task.
  80. Run - Starts a task.
  81. Stop - Ends a task.
  82. Duplicate - Copies a task. This is useful if you want to create a new task quickly and then modify it.
  83. Create Shortcut - Adds a shortcut to the task on your desktop. This is useful if you want to quickly start a task without opening RoboTask.
  84.  
  85. If you point to the Log pane and right-click, the following commands appear on the shortcut menu:
  86. Clear Log - Removes all messages from the Log pane.
  87. Copy Selected to Clipboard - Copies the lines that you have selected in the Log pane and places them on the Windows Clipboard.
  88. Select All - Selects all the lines in the Log pane so that you can quickly copy them.
  89.  
  90.   Related Topics
  91. Create Tasks
  92. Run Tasks    
  93. Edit Tasks    
  94. Customize RoboTask
  95.  
  96.  
  97. .topic 1000
  98.  
  99. 1.    Click Task > New.
  100. 2.    On the Actions tab, click the Add button.
  101. 3.    Select an action. Some of the actions require additional settings. A dialog box appears with specific settings that you can select.
  102. 4.    After entering the settings, click the Triggering Events tab.
  103. 5.    Click the Add button.
  104. 6.    Select a triggering event. Some of the triggering events require additional settings. A dialog box appears with specific settings that you can select.
  105. 7.    After entering the settings for the triggering event, click OK.
  106. 8.    To run your task, click the Run Selected Task button in the main window.
  107.  
  108. Tip
  109. Some actions or triggering events do not have specific settings that you can enter.
  110.  
  111.   Related Topics
  112. Getting Started in the RoboTask Window    
  113. Run Tasks    
  114. Edit Tasks    
  115. Customize RoboTask
  116. Task > New
  117.  
  118.  
  119.  
  120. .topic 940
  121.  
  122. 1.    In the right pane of the RoboTask window, select a task.
  123. 2.    Click Task > Run or press CTRL + ENTER on the keyboard
  124. 3.    In the right pane of the RoboTask window, the status column displays the results of running the task.
  125.  
  126. Tip
  127. You can run a task without opening RoboTask. Select a task in the RoboTask window and click Task > Create Shortcut on Desktop. This adds a shortcut to that task on your desktop. You can double-click the task to start it.    
  128.  
  129.   Related Topics
  130. Getting Started in the RoboTask Window    
  131. Create Tasks
  132. Edit Tasks    
  133. Customize RoboTask
  134.  
  135.  
  136.  
  137. .topic 930
  138.  
  139. 1.    In the RoboTask window, select a task.
  140. 2.    Click Task > Edit.
  141. 3.    On the Edit Task dialog box, select the options that you want.
  142.  
  143. Tip     
  144. To remove a task from the list in the RoboTask window, select a task and click Task > Delete.
  145.  
  146.   Related Topics
  147. Getting Started in the RoboTask Window    
  148. Create Tasks
  149. Run Tasks    
  150. Customize RoboTask
  151. Task > Edit
  152.  
  153.  
  154. .topic 970
  155.  
  156. 1.    Click Options > Settings.
  157. 2.    On the Preferences  dialog box, set the options you want.
  158.  
  159.   Related Topics
  160. Getting Started in the RoboTask Window    
  161. Create Tasks
  162. Run Tasks    
  163. Edit Tasks    
  164. Options > Settings
  165.  
  166. .topic 1020
  167.  
  168. Click Help > Purchase.
  169.  
  170.  
  171.  
  172.  
  173. .topic 1030
  174.  
  175. RoboTask is distributed as try-before-you-buy. This means:
  176.  
  177. 1.    All copyrights to RoboTask are exclusively owned by the author - NeoWise Software.
  178. 2.    Anyone may use this software during a test period of 30 days. Following this test period of 30 days or less, if you wish to continue to use RoboTask, you must purchase it.
  179. 3.    Once purchased, the user is granted a non-exclusive license to use RoboTask on one computer (i.e. a single CPU), for any legal purpose, at a time. The licensed RoboTask software may not be rented or leased, but may be permanently transferred, if the person receiving it agrees to terms of this license. If the software is an update, the transfer must include the update and all previous versions.
  180. 4.    The RoboTask trial version may be freely distributed, provided the distribution package is not modified. No person or company may charge a fee for the distribution of RoboTask without written permission from the copyright holder.
  181. 5.    ROBOTASK IS DISTRIBUTED "AS IS". NO WARRANTY OF ANY KIND IS EXPRESSED OR IMPLIED. YOU USE AT YOUR OWN RISK. THE AUTHOR WILL NOT BE LIABLE FOR DATA LOSS, DAMAGES, LOSS OF PROFITS OR ANY OTHER KIND OF LOSS WHILE USING OR MISUSING THIS SOFTWARE.
  182. 6.    You may not use, copy, emulate, clone, rent, lease, sell, modify,  decompile, disassemble, otherwise reverse engineer, or transfer the licensed program, or any subset of the licensed program, except as provided for in this agreement. Any such unauthorized use shall result in immediate and automatic termination of this license and may result in criminal and/or civil prosecution. All rights not expressly granted here are reserved by NeoWise Software.
  183. 7.    Installing and using RoboTask signifies acceptance of these terms and conditions of the license.
  184. 8.    If you do not agree with the terms of this license you must remove RoboTask files from your storage devices and cease to use the product.
  185.  
  186. Thank you for using the original RoboTask.
  187.  
  188. NeoWise Software
  189. http://www.robotask.com
  190.  
  191.  
  192. .topic 1420
  193.  
  194. RoboTask is a trademark of NeoWise Software.
  195.  
  196. Microsoft, the Windows logo, Windows, and Windows NT are registered trademarks of Microsoft Corporation. All other brands and product names are trademarks or registered trademarks of their respective owners.
  197.  
  198.  
  199.  
  200.  
  201.  
  202. .topic 1340
  203.  
  204. For building complex automation schemes, RoboTask provides two types of variables that you can use in actions and triggering events:
  205. System variables that are pre-defined.
  206. User variables that you can define yourself.
  207.  
  208. When you insert a variable name as a parameter or part of a parameter in an action or triggering event, the variable content is processed, instead of the variable name.
  209.  
  210. For example, if you want to show a message containing the day of the week, you should use the {DayOfWeek} variable.
  211.  
  212. When you run the task that contains the {DayOfWeek} variable, the variable is replaced by the name of current week day. If you insert this variable in a Show Message action that includes the message defined as "Today {DayOfWeek}!", when you run this task on Wednesday, the following message displays: "Today Wednesday!".
  213.  
  214. You can use as many variables as you need in an event or action. Any time that you define the same parameter many times, you should use a variable. This allows you to change the variable in one place and all your tasks that contain the variable update automatically.
  215.  
  216. Variables that Contain Other Variables
  217.  
  218. You can even use variables within other variables; this is useful if you want to specify a value of a variable for other variables. For example, you can define a variable with a name {Yesterday}.  {Yesterday} contains another variable with a value {MonthIncDays(-1)}/{IncDays(-1)}/{YearIncDays(-1)}. When you use the {Yesterday} variable, it returns yesterday's date.
  219.  
  220. #Arrays
  221.  
  222. To make your tasks even more powerful, you can use variables as arrays. This means you can specify more than one values separated with commas. To access the first value, use index 0: {MyVar(0)}. To access the second value, use index 1: {MyVar(1)}. And so on.
  223.  
  224. For example, if to add a variable with name {MyArray} and value One, Two, Three, you can use that variable as shown below:
  225.  
  226. {MyArray} = One, Two, Three
  227. {MyArray(0)} = One
  228. {MyArray(1)} = Two
  229. {MyArray(2)} = Three
  230.  
  231. Another example:
  232.  
  233. {MyArray} = "First item", "Second item", "Third item"
  234. {MyArray(0)} = First item
  235. {MyArray(1)} = Second item
  236. {MyArray(2)} = Third item
  237.  
  238.   Related Topics
  239. Create a Variable
  240. Add Variables to a Task
  241. Options > Variables
  242.  
  243.  
  244.  
  245.  
  246. .topic 1670
  247.  
  248. RoboTask allows you to save intermediate data in users variables. There is also a whole set of actions that cannot work without user variables. For instance, loops. While using variables, you should remember about some peculiarities.
  249.  
  250. User variables are global for all tasks
  251. It means that one and the same variable is visible, can be used and can be modified in any task. On the one hand, it is very convenient: data can be passed from one task to another. But on the other hand, if you have two tasks running simultaneously, they use one and the same variable and it is done unintentionally, you may get a completely unexpected result.
  252.  
  253. Tip
  254. If you use variables that are not supposed to be used in other tasks, use special prefixes of this task in the names of these variables.
  255. For example:
  256. TSK1_Counter, TSK1_CurrentFile, etc.
  257.  
  258. RoboTask saves user variables for future sessions
  259. Variables you create in tasks are stored until you remove them using the ½RoboTask variables╗ form (Options | Variables) or the ½Remove Variable╗ action inside the task. When you exit RoboTask, variables save their values for future sessions.
  260. As a rule, variables make sense only for the task they are created in and after using RoboTask for a while, you may get a rather long list of user variables that you do not need anymore.
  261.  
  262. Tip
  263. Insert actions removing unnecessary variables at the end of tasks.
  264.  
  265.   Related Topics
  266. Using Variables
  267. Add Variables to a Task
  268.  
  269.  
  270. .topic 1350
  271.  
  272. 1.    To define a variable, click Options > Variables.
  273. 2.    On the User Variables tab, click the Add button.
  274. 3.    On the User Variable dialog box, enter the name of the variable in the Variable Name box.
  275. 4.    Enter the values in the Initial Values box.
  276.  
  277. Tip
  278. In the Initial Value edit box, you can also type the names of other variables to define a variable.
  279.  
  280.   Related Topics
  281. Using Variables    
  282. Add Variables to a Task
  283. Options > Variables
  284.  
  285.  
  286.  
  287.  
  288. .topic 1010
  289.  
  290. You can add variables to an action or triggering event contained in a task.
  291.  
  292. 1.    When you create a task, on the Edit Task dialog box, select an action or triggering event.
  293. 2.    When you do this, some actions or triggering events display a dialog box in which you can enter specific settings for the action or event. On this dialog box, select a field and click the {V} button.
  294. 3.    On the RoboTask Variables dialog box, select a variable in the list and click the Select button.
  295. 4.    The variable appears in the field that you selected on the dialog box for the action or triggering event.
  296.  
  297.   Related Topics
  298. Using Variables    
  299. Create a Variable
  300. Options > Variables    
  301.  
  302.  
  303. á
  304.  
  305.  
  306. .topic 1680
  307.  
  308. Each task runs in the background mode independently of other tasks. You can effectively use this feature while scheduling your tasks. Suppose you need to pack several independent folders into different archive files. You can create the following task:
  309.  
  310. Pack "Folder1" into "folder1.zip"
  311. Pack "Folder2" into "folder2.zip"
  312. Pack "Folder3" into "folder3.zip"
  313.  
  314. In this case, the task will pack Folder1, Folder2 and Folder3 one by one. That is, each next folder will be processed only after the previous one is packed.
  315.  
  316. The use of background processes would be more effective. In this case you need to create three different tasks and each of them will pack the corresponding folder. In this case, the main task will look like this:
  317.  
  318. Start task "Pack folder1" without waiting
  319. Start task "Pack folder2" without waiting
  320. Start task "Pack folder3" without waiting
  321.  
  322. Running such a task will be the same as running three tasks "Pack folder1", "Pack folder2" and "Pack folder3". Each of these tasks will run independently of the others and the total time of packing all three files will be a bit shorter than in case with successive processing.
  323.  
  324.  
  325.   Related Topics
  326. Task synchronization
  327.  
  328. .topic 1690
  329.  
  330. Let us try to make the task described in the previous section a bit more complicated. Suppose you need to pack three folders in three different files and then write them to a CD. As you remember, we have started three different tasks to pack the folders. It means that we must wait until all three tasks are finished before we can write the archives to a CD.
  331. The "Wait for Task" action is used for that. Let us modify our task in the following way:
  332.  
  333. Start task "Pack folder1" without waiting
  334. Start task "Pack folder2" without waiting
  335. Start task "Pack folder3" without waiting
  336. Wait for Task "Pack folder1" for 10 min.
  337. Wait for Task "Pack folder2" for 10 min.
  338. Wait for Task "Pack folder3" for 10 min.
  339. Write files folder1.zip, folder2.zip, folder3.zip to CD
  340.  
  341. Thus, we start three simultaneous processes in order to pack the necessary data and after all three processes are sure to be finished, we write the archive files to a CD.
  342.  
  343.   Related Topics
  344. Running tasks simultaneously
  345. Wait for Task
  346.  
  347.  
  348. .topic 1700
  349.  
  350. Sometimes we need to make some nonstandard calculation, analyze a string or modify it according to a certain algorithm. The Basic programming language will help you in that. The Basic plugin for RoboTask is not included in the main distribution package. You can download it from the RoboTask site and install additionally.
  351. Basic is a simple and at the same time quite powerful programming tool oriented towards both beginners and professionals. You can use a BASIC script to access user and system variables in RoboTask, as well as other tasks. The BASIC plugin comes together with the full help on the BASIC language. The installation file also includes some sample uses. The description of the Evaluate and Basic script actions, as well as the mechanism of interaction with RoboTask is described below.
  352. Almost anyone can learn how to write small procedures in the BASIC language. The use of BASIC in tasks extends available actions beyond the set of RoboTask actions. Experienced users can use Windows APIs and third-party COM objects in their procedures written in BASIC without any limitations.
  353.  
  354.   Related Topics
  355. Evaluate
  356. Basic script
  357. Also see Basic language help
  358.  
  359.  
  360. .topic 1710
  361.  
  362. RoboTask can run in two modes:
  363.  
  364. As a regular application
  365. As an NT service
  366.  
  367. An NT service is started together with the operating system and runs even if you are not logged on. If you correctly create your tasks and configure triggering events, it will be enough just to switch on the computer for RoboTask to start doing what it is supposed to do. This mode is important for those computers that are used as servers in your office.
  368.  
  369. The NT service mode is not available on the Windows 9x/Me platform. The NT service mode is not installed by default. In order to install the RoboTask service, you should click the following shortcut in the system menu: Start | Programs | RoboTask | NT Service | Install Service.
  370. The RoboTask group contains the following shortcuts for controlling the NT service mode:
  371.  
  372. Install Service - installs the RoboTask service on the system;
  373. Uninstall Service - removes the RoboTask service from the system;
  374. Reinstall Service - reinstalls the RoboTask service with the default parameters;
  375. Start Service - starts the RoboTask service;
  376. Stop Service - stops the RoboTask service.
  377.  
  378.   Related Topics
  379. Custom variables
  380. Running tasks simultaneously
  381. Task synchronization
  382. Using built-in Basic
  383. Errors processing
  384.  
  385.  
  386.  
  387. .topic 1720
  388.  
  389. If there is an error occurs in any step during a task, RoboTask records an error message to the task log and stops the task by default. You can change this behavior. To do it, you should select the "Advanced" tab in the task editor and set the "If Error Occurred" parameter to "Continue Execution". In this case, the task will not be stopped in case of an error.
  390. The system variable {IsError} is used to analyze if there was an error in the previous step. This variable contains "True" if there was an error in the previous step and "False" if there was no error in the previous step.
  391.  
  392.   Related Topics
  393. Custom variables
  394. Running tasks simultaneously
  395. Task synchronization
  396. Using built-in Basic
  397. Running RoboTask as an NT service
  398.  
  399.  
  400.  
  401. .topic 750
  402.  
  403. Allows you to add a new task. After you select the command, the Add Task dialog box displays, allowing you to select the following tabs to create a task:
  404. Actions tab
  405. Triggering Events tab
  406. Specific Settings tab
  407.  
  408. #Actions tab
  409.  
  410.  
  411. Action List
  412. Displays a list of the actions you have selected for the task you are creating or modifying. Click the Add button to add an action. Select an action in the Action List and click the Edit button to modify the action parameters.
  413.  
  414. When you start the current task, the actions run in the order in which they appear in this list.
  415. Click the ╟ & ╚ buttons to move an action up or down in the order listed.
  416.  
  417. Add
  418. Place the cursor in a row of the Action List where you want to add an action. You can then click the Add button to display a list of actions that you can add to the task.
  419.  
  420. Edit
  421. Select an action in the Action List and click the Edit button to modify the parameters, or settings, for the action.
  422.  
  423. Remove
  424. Select an action and click the Remove button to remove the action from the task.
  425.  
  426. Move Step Up
  427. Select an action in the Action List and click ╟ to move the action up in the list. This ensures the action runs earlier in the process when the task runs.
  428.  
  429. Move Step Down
  430. Select an action in the Action List and click ╚ to move the action down in the list. This ensures the action runs later in the process when the task runs.
  431.  
  432. Enabled
  433. If the check box is cleared, the task is disabled and you must run it manually by double-clicking the task in the RoboTask window.
  434.  
  435. Tip
  436. To change the Enabled setting, select a task in the RoboTask window and right-click.
  437.  
  438. #Triggering Events tab
  439.  
  440.  
  441. Event List
  442. Displays a list of the events you have selected for the task you are creating or modifying. The order in which events appear in the list does not matter.
  443.  
  444. Run When RoboTask Starts
  445. If this check box is selected, the task will run automatically when RoboTask starts.
  446.  
  447. Run When RoboTask Quits
  448. If this check box is selected, the task will run automatically when RoboTask quits.
  449.  
  450. Add
  451. Click the Add button to display a list of events that you can add to the task.
  452.  
  453. Edit
  454. Select an event in the Event List and click the Edit button to modify the parameters, or settings, for the event.
  455.  
  456. Remove
  457. Select an event and click the Remove button to remove the event from the task.
  458.  
  459.  
  460. #Advanced tab
  461.  
  462.  
  463. Log Level
  464.  
  465. Select the status messages you want to record in the log file:
  466. Nothing
  467. Errors Only
  468. Errors and Warnings
  469. All Messages
  470.  
  471. Action After Completion
  472.  
  473. Select an option to run a task:
  474. Nothing - Nothing happens when the task completes all actions.
  475. Disable Task - The task is disabled when the task completes all actions. This is useful if you want to run a task once and save the task to use again later. You can change this later.
  476. Delete Task - The task is removed from the computer permanently when the task completes all actions. This is useful if you want to run a task once and do not need it again. You cannot use the task again when you select this option and run the task.
  477.  
  478.  
  479.   Related Topics
  480. Task > Edit    
  481. Task > Delete        
  482. Task > Run    
  483. Task > Stop    
  484. Task > Duplicate    
  485. Task > Create Shortcut on Desktop    
  486. Task > Exit    
  487.  
  488.  
  489.  
  490. .topic 770
  491.  
  492. Allows you to edit a task. After you select the command, the Edit Task dialog box displays, allowing you to select the following items to create a task:
  493. Actions tab
  494. Triggering Events tab
  495. Specific Settings tab
  496.  
  497.   Related Topics
  498. Task > New    
  499. Task > Delete        
  500. Task > Run    
  501. Task > Stop    
  502. Task > Duplicate    
  503. Task > Create Shortcut on Desktop    
  504. Task > Exit    
  505.  
  506.  
  507.  
  508. .topic 780
  509.  
  510. Removes a task from the RoboTask and deletes its associated file.
  511.  
  512.   Related Topics
  513. Task > New    
  514. Task > Edit    
  515. Task > Run    
  516. Task > Stop    
  517. Task > Duplicate    
  518. Task > Create Shortcut on Desktop    
  519. Task > Exit    
  520.  
  521.  
  522.  
  523. .topic 790
  524.  
  525. Starts the task that you selected in the RoboTask window. This is useful for testing your task to ensure it runs correctly.
  526.  
  527.   Related Topics
  528. Task > New    
  529. Task > Edit    
  530. Task > Delete        
  531. Task > Stop    
  532. Task > Duplicate    
  533. Task > Create Shortcut on Desktop    
  534. Task > Exit    
  535.  
  536.  
  537.  
  538. .topic 800
  539.  
  540. Allows you to stop the task that you are running in the RoboTask window.
  541.  
  542.   Related Topics
  543. Task > New    
  544. Task > Edit    
  545. Task > Delete        
  546. Task > Run    
  547. Task > Duplicate    
  548. Task > Create Shortcut on Desktop    
  549. Task > Exit    
  550.  
  551.  
  552.  
  553. .topic 810
  554.  
  555. Copies the task that you have selected in the RoboTask window. This is useful if you want to quickly create several tasks and then edit them.
  556.  
  557.   Related Topics
  558. Task > New    
  559. Task > Edit    
  560. Task > Delete        
  561. Task > Run    
  562. Task > Stop        
  563. Task > Create Shortcut on Desktop    
  564. Task > Exit    
  565.  
  566.  
  567.  
  568. .topic 820
  569.  
  570. Adds a shortcut to the task on your desktop. This is useful if you want to quickly start a task without opening RoboTask window. After you select one or more tasks in the RoboTask window, click  Task > Create Shortcut on Desktop. The shortcut appears on your desktop with the name of the task.
  571.  
  572. For example, if you select a task named "Hello, World!" and click this command, a shortcut called "Hello, World!" appears on your desktop.
  573.  
  574.   Related Topics
  575. Task > New    
  576. Task > Edit    
  577. Task > Delete        
  578. Task > Run    
  579. Task > Stop    
  580. Task > Duplicate        
  581. Task > Exit    
  582.  
  583.  
  584.  
  585. .topic 830
  586.  
  587. Closes the RoboTask window and stops the software.
  588.  
  589.   Related Topics
  590. Task > New    
  591. Task > Edit    
  592. Task > Delete        
  593. Task > Run    
  594. Task > Stop    
  595. Task > Duplicate    
  596. Task > Create Shortcut on Desktop    
  597.  
  598.  
  599. .topic 840
  600.  
  601. Displays or hides the log window at the bottom of the RoboTask window. The log window shows the results of the task that you run and any errors that occur.
  602.  
  603.   Related Topics
  604. Options > View Toolbar    
  605. Options > Settings
  606. Options > Variables    
  607.  
  608.  
  609. .topic 850
  610.  
  611. Displays or hides the buttons at the top of the RoboTask window. These buttons allow you to add, edit, run, and stop tasks.
  612.  
  613.  
  614.  
  615.   Related Topics
  616. Options > View Log    
  617. Options > Settings
  618. Options > Variables    
  619.  
  620.  
  621. .topic 860
  622.  
  623. Allows you to set preferences for RoboTask. You can set preferences for how RoboTask starts, plug-ins, or service mode.
  624.  
  625. General tab
  626. Plug-ins tab
  627. NT Service tab
  628.  
  629. #General tab
  630.  
  631. Minimize on Run
  632. Click this check box so that RoboTask is minimized when you run the software.
  633.  
  634. Run on Windows Startup
  635. Runs RoboTask as soon as Windows starts up.
  636.  
  637. Close as Minimize
  638. If this option is selected, when you click the X button on the main window caption, RoboTask will minimize. This is useful for preventing of casual closing of RoboTask.
  639.  
  640. Task Folder
  641. Set the folder where you want to save tasks that you create.  You can click the browse button to select a folder.
  642.  
  643. Log Folder
  644. Enter a folder where you want to save log files. You can click the browse button to select a folder.
  645.  
  646. Max Log Size (in Lines)
  647. Enter how many lines of data to record in a log file. For example, if you enter 300, the log file will contain no more than 300 lines of text.
  648.  
  649. #Plug-ins tab
  650.  
  651. List of Active Plug-ins
  652. Displays a list of available plug-ins for RoboTask. You can get more information when you click the Information or About buttons.
  653.  
  654. Configure
  655. Select a plug-in from the List of Active Plug-ins box and click Configure to enter settings.
  656.  
  657. Information
  658. Displays a list of components for the plug-in that you have selected in the List of Active Plug-ins box.
  659.  
  660. About
  661. Displays information about the company or authors of the plug-in that you have selected in the List of Active Plug-ins box.
  662.  
  663. #Service tab
  664.  
  665. On Windows NT, Windows 2000 and Windows XP you can run RoboTask as a Service. An Service is a background process that is loaded by the Service Control Manager of the Windows NT operating system. Services are usually loaded when Windows boots up, before anyone logs on.
  666.  
  667. Service mode is useful if you want to run a process in the background. However, services are background programs that run all the time and are activated automatically when Windows NT boots up. Services stop when Windows NT shuts down.
  668.  
  669. When RoboTask is Running as NT Service
  670. Allows you to specify settings when you want to run RoboTask as a Service.
  671.  
  672. Logon Process as Specified User
  673. Select this option if you want the RoboTask log on as Specified User and get its privileges.
  674.  
  675. Domain Name
  676. Enter the name of the domain or server whose account database contains the specified UserName account.
  677.  
  678. User Name
  679. Enter the name of the user account to log on to.
  680.  
  681. Password
  682. Enter the password of the user account.
  683.  
  684.   Related Topics
  685. Options > View Log    
  686. Options > View Toolbar    
  687. Options > Variables    
  688.  
  689.  
  690. .topic 870
  691.  
  692. Allows you to define variables for RoboTask. This command also displays a list of system variables available in RoboTask.
  693. System Variables tab
  694. User's Variables tab
  695.  
  696. Variables are strings that contain information such as drive, path, or file name. Variables can control the behavior of various processes. For example, the {TEMPDIR} system variable specifies the location where processes, such as tasks or programs, place temporary files.
  697.  
  698. You can not modify System variables, but can add, modify, or remove your own variables on the User Variables tab.
  699.  
  700. #System Variables tab
  701.  
  702. The System Variables tab displays a list of the system variables.
  703.  
  704.  
  705. Categories
  706. Displays a list of all the system variables and their values. You can click [All] to see a complete list or click one of the following categories:
  707. Date & Time
  708. Files & Folders
  709. System Info
  710. Window
  711.  
  712. Variables
  713. Displays the system variable names and their descriptions.
  714.  
  715. #User's Variables tab
  716.  
  717.  
  718.  
  719. Name
  720. Displays the name of the user variables that you create.
  721.  
  722. Value
  723. Lists the value of the user variables that you set when you create or modify the variable.
  724.  
  725. Add
  726. Allows you to create a new user variable to use in many tasks.
  727.  
  728. Edit
  729. Allows you to edit the value of a variable.
  730.  
  731. Remove
  732. Allows you to remove the selected variable.
  733.  
  734.   Related Topics
  735. Options > View Log    
  736. Options > View Toolbar    
  737. Options > Settings
  738.  
  739.  
  740.  
  741.  
  742. .topic 880
  743.  
  744. If this option is cleared, the tasks will not run automatically, i.e. all your tasks are disabled. You may run tasks only manually.
  745.  
  746.   Related Topics
  747. Tools > Enable All Tasks in List    
  748. Tools > Disable All Tasks in List    
  749.  
  750.  
  751.  
  752. .topic 890
  753.  
  754. Enables all tasks that are listed in the current task folder. To enable one task, double-click it and, in the appeared dialog window, select the Enabled check box and click OK.
  755.  
  756.   Related Topics
  757. Tools > Enable Automation    
  758. Tools > Disable All Tasks in List    
  759.  
  760.  
  761.  
  762. .topic 900
  763.  
  764. Disables all tasks that are listed in the current task folder. To disable one task, double-click it and, in the appeared dialog window, clear the Enabled check box and click OK.
  765.  
  766.   Related Topics
  767. Tools > Enable Automation    
  768. Tools > Enable All Tasks in List    
  769.  
  770.  
  771.  
  772.  
  773.  
  774. .topic 910
  775.  
  776. Displays this RoboTask Help.
  777.  
  778.   Related Topics
  779. Help > Send Bug Report    
  780. Help > About    
  781.  
  782.  
  783.  
  784.  
  785. .topic 920
  786.  
  787. Displays a dialog window which allows to send a report about a bug you found to the developers of RoboTask. Enter information about a problem and then click the Submit button.
  788.  
  789.   Related Topics
  790. Help > Help Topics        
  791. Help > About    
  792.  
  793.  
  794.  
  795.  
  796. .topic 760
  797.  
  798. Displays information about your version of RoboTask.
  799.  
  800.   Related Topics
  801. Help > Help Topics        
  802. Help > Send Bug Report    
  803.  
  804.  
  805. .topic 1040
  806.  
  807. Use this action to run the application or open a document that you specify.  If a document is specified, the application associated with the document opens it.
  808.  
  809. Run Program/Open Document is one of the most commonly-used actions in RoboTask and one of the most powerful. The most common usage is to start an application or open a document and then send keystrokes or perform other interactive actions. For example, you can use this action to open a log file in Notepad immediately after you back up your files.
  810.  
  811.  
  812. Program or Document File Name
  813. Enter the file name of the target application or a document. If a document file is specified, the associated application is used to open it.
  814.  
  815. Parameters
  816. Enter the parameters, if any. If the Program or Document File Name box specifies an executable file, you can specify the parameters to be passed to the application. The format of this parameter is determined by the application. If Program or Document File Name  box specifies a document file, the information in the Parameters box is ignored.
  817.  
  818. Default Folder
  819. Specifies the default folder to start the task in. If not specified, the folder of the application is used.
  820.  
  821. Window
  822. Specifies how an application is displayed when it is opened.
  823.  
  824. Wait Options
  825. There are three choices:
  826. Don't wait - the next action executes immediately after the program starts.
  827. Wait until the application is ready for input - the next action executes only after the program started and is ready for input. This option is useful when you want to perform any interactive actions like Send Keystrokes.
  828. Wait untill the application exits - the next action executes only after the program exits.
  829.  
  830.  
  831. Variable
  832. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  833.  
  834.  
  835.   Related Topics
  836. Print Document        
  837. Send Network Message    
  838. Send Keystrokes    
  839. Pause    
  840. Log Off
  841. SQL Query
  842. Wait for process
  843. Comment
  844.  
  845. .topic 1050
  846.  
  847. Use this action to print one or more document files, such as Microsoft Word .Doc files, to the default printer. For example, you can use this action to automatically print daily backup logs.
  848.  
  849.  
  850. Files to Print
  851. Enter the files that you want to print. This is a required option. Wildcards are allowed. Click the Plus button to add files to the list. To clear the list, click the X button.
  852.  
  853.  
  854.  
  855.  
  856. Variable
  857. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  858.  
  859.  
  860.   Related Topics
  861. Run Program/Open Document    
  862. Send Network Message    
  863. Send Keystrokes    
  864. Pause    
  865. Log Off
  866. SQL Query
  867. Wait for process
  868. Comment
  869.  
  870.  
  871.  
  872. .topic 1070
  873.  
  874. Sends keystrokes to a window that you specify or the window that is currently in focus. After you have opened an application programmatically, you can use this action to access menu commands using shortcut, or hot, keys, such as ALT + F to open the File menu. Send Keystrokes is one of the most powerful actions for manipulating applications.
  875.  
  876. Target
  877. Specifies the window to send the keystrokes to. There are two choices:
  878. Current Window - the keystrokes are sent to the currently focused window.
  879. Specified Window - the specified window will be focused and the keystrokes are sent to it.
  880.  
  881. Part of Window Caption
  882. Enter the caption, or part of the caption, of the window to send keystrokes to. This option is available only when you the Specified Window option is selected.
  883.  
  884. Fixed Window
  885. Click this check box when you want to prevent a user from switching windows during the time that the action runs.
  886.  
  887. Keystrokes
  888. Specifies the keystrokes that the action sends to the window. For the alpha-numeric characters, type these keys on the keyboard. For the special keys, such as Esc, F11, Left Arrow Key, and Ctrl+Alt+A, click the Insert a Key button.
  889.  
  890. Insert a Key
  891. Click this button to insert special keys such as Esc, F11, Left Arrow Key, and Ctrl+Alt+A. You can also insert a pause between keystrokes to give time for program operations, such as opening a file.
  892.  
  893. Variable
  894. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  895.  
  896.  
  897.   Related Topics
  898. Run Program/Open Document    
  899. Print Document        
  900. Send Network Message    
  901. Pause    
  902. Log Off
  903. SQL Query
  904. Wait for process
  905. Comment
  906.  
  907.  
  908.  
  909.  
  910. .topic 1090
  911.  
  912. Completes one of the following actions:
  913. Logs off the current user,
  914. Shuts down the computer,
  915. Restarts the system.
  916.  
  917. For example, you can use this action to automatically shut down a computer every night after your defragger program finishes cleaning up your hard drive.
  918.  
  919.  
  920. Action
  921. Select one of the following values:
  922. Shut down the computer
  923. Shut down the computer and power off
  924. Restart the computer
  925. Log Off
  926.  
  927.   Related Topics
  928. Run Program/Open Document    
  929. Print Document        
  930. Send Network Message    
  931. Send Keystrokes    
  932. Pause    
  933. SQL Query
  934. Wait for process
  935. Comment
  936.  
  937.  
  938.  
  939. .topic 1080
  940.  
  941. Waits for a specified number of milliseconds and then continues executing tasks. This action is useful when you want to perform extensive operations that require a delay between actions.
  942.  
  943. For example, you might want to create a pause between printing a document and closing it to prevent a printer error. This pause allows time for the document to spool.
  944.  
  945.  
  946. Pause
  947. Enter the number of milliseconds * 100.
  948.  
  949.   Related Topics
  950. Run Program/Open Document    
  951. Print Document        
  952. Send Network Message    
  953. Send Keystrokes    
  954. Log Off
  955. SQL Query
  956. Wait for process
  957. Comment
  958.  
  959.  
  960.  
  961.  
  962. .topic 1640
  963.  
  964. Executes an SQL query. This action is useful when you want to update a database. If you want to SELECT from a database, use the Dataset Loop action instead.
  965.  
  966.  
  967. Connection String
  968. A string with attribute/value pairs for information required to log on to a database and point to a specific database. Click the browse button to open the Microsoft Data Link Properties dialog box. You can press F1 to access Help about this dialog box.
  969.  
  970. SQL Query
  971. Enter the query string in SQL syntax.
  972.  
  973. Variable
  974. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  975.  
  976.  
  977.   Related Topics
  978. Run Program/Open Document    
  979. Print Document        
  980. Send Network Message    
  981. Send Keystrokes    
  982. Log Off
  983. Pause
  984. Wait for process
  985. Comment
  986.  
  987.  
  988.  
  989.  
  990.  
  991. .topic 1730
  992.  
  993. Pauses the task and waits until the selected process (processes) is finished. After the monitored process is finished, the task is resumed. If the specified process is not in the memory at the moment when the action is due, the task is not paused.
  994. This action is necessary to synchronize your task with an external application. For example, you may need to wait until the packing program finishes its work before you can copy the packed file to the Backup folder.
  995.  
  996. Process
  997. You can either select the process from the list of processes that are currently running or type its name manually. You do not have to write the full path to the EXE file if it does not matter where this application was launched from.
  998.  
  999. If more than one matching process
  1000. If there are several running processes matching the specified one at the moment when the action is due, you can specify one of three modes
  1001.  
  1002. Wait for Oldest - wait until the process launched first from the matching group is finished;
  1003. Wait for Newest - wait until the process launched last from the matching group is finished;
  1004. Wait for All - wait until all matching processes are finished.
  1005.  
  1006. Waiting
  1007. This parameter defines the timeout in seconds to wait until the process is finished. You can also specify an infinite timeout.
  1008. If the timeout is over, but the process is not finished, the action will generate the following error: Timeout is over.
  1009.  
  1010. Assign Exit Code of Process to Variable
  1011. If you select waiting for one process (Wait for Oldest or Wait for Newest), you can assign its exit code to a user variable. A lot of console utilities (for example, packing software) can use this code to inform the application that initialed them about errors in their work.
  1012.  
  1013.   Related Topics
  1014. Run Program/Open Document    
  1015. Print Document        
  1016. Send Network Message    
  1017. Send Keystrokes    
  1018. Log Off
  1019. Pause
  1020. SQL Query
  1021. Comment
  1022.  
  1023.  
  1024.  
  1025. .topic 1740
  1026.  
  1027. This action does nothing and is used only as a visual comment for the task.
  1028.  
  1029.   Related Topics
  1030. Run Program/Open Document    
  1031. Print Document        
  1032. Send Network Message    
  1033. Send Keystrokes    
  1034. Log Off
  1035. Pause
  1036. SQL Query
  1037. Wait for process
  1038.  
  1039.  
  1040.  
  1041. .topic 1100
  1042.  
  1043. Displays a message box that displays custom text or plays a sound file. For example, you can use this action to display a message and play a sound every time your backup finishes archiving the files.
  1044.  
  1045. Tip
  1046. The message box displayed by this action has an OK button. You can display a message box with a Yes and No button with the Question Dialog action.
  1047.  
  1048.  
  1049. Show Message
  1050. Click this check box to display the message box.
  1051.  
  1052. Message Text
  1053. Enter the text for the message box.
  1054.  
  1055. Message Icon
  1056. Select the style of the icon for the message box:
  1057. Exclamation
  1058.  
  1059.  
  1060.  
  1061. Information
  1062.  
  1063.  
  1064.  
  1065. Question
  1066.  
  1067.  
  1068.  
  1069. Error
  1070.  
  1071.  
  1072.  
  1073. Play Sound
  1074. Click this check box to play a sound. When you click the check box, you can click the browse button to select a .wav file on the computer.
  1075.  
  1076. Test
  1077. Click this button to ensure that the parameters for the current action work.
  1078.  
  1079.  
  1080. Variable
  1081. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1082.  
  1083.  
  1084.   Related Topics
  1085. Question Dialog    
  1086. Open Dialog
  1087. Save Dialog
  1088. Browse for Folders
  1089. Browse for Computers
  1090. Input Box
  1091.  
  1092.  
  1093. .topic 1110
  1094.  
  1095. Displays a message box with specified text and two buttons: OK&Cancel or Yes&No. For example, after your system is backed up, you can use this action to display a message asking you if you want to open the log file.
  1096.  
  1097.  
  1098. Question Text
  1099. Enter the text for the message box.
  1100.  
  1101. Buttons
  1102. Click to set the style of buttons that appear on the message box.
  1103. OK & Cancel
  1104. Yes & No
  1105.  
  1106. Action
  1107. Select an option to specify an action when user clicks a button:
  1108. Stop task
  1109. Assign variable
  1110.  
  1111. Stop Task On
  1112. Select an option to specify when the task stops when the user clicks a button on the message box:
  1113. Cancel/No
  1114. OK/Yes
  1115.  
  1116. Auto Choice
  1117. Click an option to specify when the task continue or stops if a user does not select a button on the message box.
  1118. None
  1119. Cancel/No
  1120. OK/Yes
  1121.  
  1122. After ___ Sec.
  1123. Enter the number of seconds to wait before implementing the button that you selected in the Auto Choice area.
  1124.  
  1125. Variable
  1126. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1127.  
  1128.  
  1129. Test
  1130. Click this button to ensure that the parameters for the current action work.
  1131.  
  1132.  
  1133.   Related Topics
  1134. Show Message/Play Sound
  1135. Open Dialog
  1136. Save Dialog
  1137. Browse for Folders
  1138. Browse for Computers
  1139.  
  1140.  
  1141.  
  1142. .topic 170
  1143.  
  1144. Displays a dialog box that allows you to open file. You can set the title of the dialog box, the initial folder, and the type of files a user can open.
  1145.  
  1146. For example, you can use this action in a task in which you might want to select file for uploading to FTP server.
  1147.  
  1148. Dialog Caption
  1149. Enter the caption of the dialog box. For example, you could enter a caption "Open Log Files" for the dialog box.
  1150.  
  1151. Initial Folder
  1152. Set the folder that you want as the starting folder for the dialog box. For example, you could enter "My Documents" or "Daily Backups." Click the browse button to select a folder.
  1153.  
  1154. Filter
  1155. Enter the criteria for including file types that you want the dialog box to open. These types appear in options for opening files on the dialog box, such as Files of Type. Click the ... button to add types with the Filter Editor dialog box. You can click a field in this dialog box and add file type extensions and a name for the file type.
  1156.  
  1157. Assign Selected File Name to Variable
  1158. Enter a variable name to store the selected file name to; for use in other actions of task.
  1159.  
  1160. Assign This Value if No File Selected
  1161. Assign a value to store if no file is selected, i.e. the Cancel button was clicked.
  1162.  
  1163. Variable
  1164. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1165.  
  1166.  
  1167.   Related Topics
  1168. Show Message/Play Sound
  1169. Question Dialog    
  1170. Save Dialog
  1171. Browse for Folders
  1172. Browse for Computers
  1173.  
  1174. .topic 180
  1175.  
  1176. Opens a dialog box that allows users to save a file. You can specify the title of the dialog box, the start folder, and which types of files a user can save. For example, you might want to use this action that copies a file and you want to specify where to copy the file.
  1177.  
  1178.  
  1179. Dialog Caption
  1180. Enter the caption of the dialog box. For example, you could enter a caption "Save Log Files" for the dialog box.
  1181.  
  1182. Initial Folder
  1183. Set the folder that you want as the starting folder for the dialog box. For example, you could enter "My Documents" or "Daily Backups." Click the browse button to select a folder.
  1184.  
  1185. Filter
  1186. Enter the criteria for including file types that you want the dialog box to save. These types appear in options on the dialog box, such as Files of Type. Click the ... button to add types with the Filter Editor dialog box. You can click a field in this dialog box and add file type extensions and a name for the file type.
  1187.  
  1188. Assign Selected File Name to Variable
  1189. Enter a variable name to store the selected file name to; for use in other actions of task.
  1190.  
  1191. Assign This Value if No File Selected
  1192. Assign a value to store if no file is selected, i.e. the Cancel button was clicked.
  1193.  
  1194. Variable
  1195. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1196.  
  1197.  
  1198.   Related Topics
  1199. Show Message/Play Sound
  1200. Question Dialog    
  1201. Open Dialog
  1202. Browse for Folders
  1203. Browse for Computers
  1204.  
  1205.  
  1206. .topic 190
  1207.  
  1208. Displays a dialog box that allows users to browse folders on a local or remote drives. You can set the title of the dialog box, the start folder, and what type of files a user can select. For example, if you create a task that downloads files from Internet, you can display this dialog box so you can select where to save the downloaded files.
  1209.  
  1210.  
  1211. Dialog Caption
  1212. Enter the caption of the dialog box. For example, you could enter a caption "Select Destination Folder" for the dialog box.
  1213.  
  1214. Initial Folder
  1215. Set the folder that you want as the starting folder for the dialog box. For example, you could enter "My Documents" or "Daily Backups." Click the browse button to select a folder.
  1216.  
  1217. Filter
  1218. This option is not available for this action.
  1219.  
  1220. Assign Selected Folder Name to Variable
  1221. Enter a value to store the selected file name in a variable expression for use in other actions or tasks.
  1222.  
  1223. Assign This Value if No Folder Selected
  1224. Assign a value to store if no folder is selected, i.e. the Cancel button was clicked.
  1225.  
  1226.  
  1227. Variable
  1228. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1229.  
  1230.  
  1231.   Related Topics
  1232. Show Message/Play Sound
  1233. Question Dialog    
  1234. Open Dialog
  1235. Save Dialog
  1236. Browse for Computers
  1237.  
  1238.  
  1239.  
  1240.  
  1241. .topic 200
  1242.  
  1243. Displays a dialog box that allows a user to select computers on the local network. You can set the title of the dialog box and other settings. For example, in a task that sends a network message, you can select a computer to send a message to.
  1244.  
  1245.  
  1246. Dialog Caption
  1247. Enter the caption of the dialog box. For example, you could enter a caption "Browse Backup Server" for the dialog box.
  1248.  
  1249. Initial Folder
  1250. This option is not available for the Browse for Computers action.
  1251.  
  1252. Filter
  1253. This option is not available for the Browse for Computers action.
  1254.  
  1255. Assign Selected Computer Name to Variable
  1256. Enter a variable name to store the selected computer name to; for use in other actions of task.
  1257.  
  1258. Assign This Value if No Computer Selected
  1259. Assign a default value to store if no computer is selected.
  1260.  
  1261. Variable
  1262. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1263.  
  1264.  
  1265.   Related Topics
  1266. Show Message/Play Sound
  1267. Question Dialog    
  1268. Open Dialog
  1269. Save Dialog
  1270. Browse for Folders
  1271.  
  1272.  
  1273.  
  1274.  
  1275. .topic 1650
  1276.  
  1277. Displays an input dialog box that lets the user enter a string and assigns the entered value to a specified variable.
  1278.  
  1279. Prompt String
  1280. Specify the text that prompts the user to enter input in the edit box.
  1281.  
  1282. Assign Entered Value to Variable
  1283. Enter a variable name to store the entered value to; for use in other actions of task.
  1284.  
  1285. Assign this Value, if Cancel Pressed
  1286. Assign a default value to store if Cancel is pressed.
  1287.  
  1288. Variable
  1289. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1290.  
  1291.  
  1292. Test
  1293. Click this button to ensure that the parameters for the current action work.
  1294.  
  1295.  
  1296.   Related Topics
  1297. Show Message/Play Sound
  1298. Question Dialog    
  1299. Open Dialog
  1300. Save Dialog
  1301. Browse for Folders
  1302. Browse for Computers
  1303.  
  1304.  
  1305. .topic 1120
  1306.  
  1307. Copies or moves one or more files that you specify. You can set the source and the destination. Wildcards are allowed. For example, you can use this action to copy backup archives from your computer to another computer on the network.
  1308.  
  1309.  
  1310. Files
  1311. Enter the files you want to copy or move. Wildcards are allowed. Use the Plus buttons to add files to the list. To clear the list, click the X button.
  1312.  
  1313.  
  1314.  
  1315.  
  1316. Destination Folder
  1317. Enter the folder to which you want to move or copy the files. You can click the browse button to find folders.
  1318.  
  1319. If File Exists
  1320. Specify the action to take if a file already exists in the destination location.
  1321. Overwrite - replaces the destination file with the file you are copying or moving.
  1322. Rename - renames the source file when you copy or move it to the new location.
  1323.  
  1324. Recurse to Subfolders
  1325. Copies or moves all the files in the subfolders of the current directory.
  1326.  
  1327. Move
  1328. Deletes the original files after you copy or move them to a new location.
  1329.  
  1330. Variable
  1331. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1332.  
  1333.  
  1334.   Related Topics
  1335. Rename File    
  1336. Delete File
  1337. Write Text File
  1338. Search for Files    
  1339. Change Folder    
  1340. Create Folder    
  1341. Rename Folder        
  1342. Remove Folder        
  1343. Synchronize Folders    
  1344. Wait for file
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350. .topic 1130
  1351.  
  1352. Renames one or more specified files. Wildcards are allowed. For example, you can copy the files to another folder and automatically rename them using this action.
  1353.  
  1354.  
  1355. Files
  1356. Enter the files you want to rename. Use the Plus buttons to add files or folders to the list. To clear the list, click the X button.
  1357.  
  1358.  
  1359.  
  1360.  
  1361. Rename To
  1362. Enter the name or partial name for the new filename. You can use a wildcard if you want to rename part of the filename.
  1363.  
  1364. Recurse to Subfolders
  1365. Renames the files in the subfolders of the current directory.
  1366.  
  1367. Variable
  1368. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1369.  
  1370.  
  1371.   Related Topics
  1372. Copy/Move File    
  1373. Delete File
  1374. Write Text File
  1375. Search for Files    
  1376. Change Folder    
  1377. Create Folder    
  1378. Rename Folder        
  1379. Remove Folder        
  1380. Synchronize Folders    
  1381. Wait for file
  1382.  
  1383. .topic 1140
  1384.  
  1385. Deletes one or more files you specify. Wildcards are allowed. For example, you can use this action to automatically delete cookies from your Internet cache every day to protect your privacy and computer security.
  1386.  
  1387.  
  1388. Files
  1389. Enter the files you want to delete. Use the Plus buttons to add files or folders to the list. To clear the list, click the X button.
  1390.  
  1391.  
  1392.  
  1393.  
  1394. Delete to Recycle Bin
  1395. Moves files to the Windows Recycle Bin. Use this flag to prevent possible data loss.
  1396.  
  1397. Recurse to subfolders
  1398. Deletes the files in the subfolders of the current directory.
  1399.  
  1400. Delete Folders
  1401. Removes the subfolders. This option works only with wildcards.
  1402.  
  1403. Variable
  1404. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1405.  
  1406.  
  1407.   Related Topics
  1408. Copy/Move File    
  1409. Rename File    
  1410. Write Text File
  1411. Search for Files    
  1412. Change Folder    
  1413. Create Folder    
  1414. Rename Folder        
  1415. Remove Folder        
  1416. Synchronize Folders    
  1417. Wait for file
  1418.  
  1419. .topic 1150
  1420.  
  1421. Creates a text file with the specified text. For example, you can write a text file listing which user is logged into a computer at a particular time.
  1422.  
  1423.  
  1424. Text File
  1425. Enter the name of the text file to save. You can click the browse button to select a file.
  1426.  
  1427. Text
  1428. Enter the text that you want saved in the file.
  1429.  
  1430. If File Exists
  1431. Specify the action to take if a file already exists in the destination location.
  1432. Overwrite - replaces the destination file with the new file.
  1433. Append - append specified text at the end of existing text file.
  1434.  
  1435. Variable
  1436. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1437.  
  1438.  
  1439.   Related Topics
  1440. Copy/Move File    
  1441. Rename File    
  1442. Delete File
  1443. Search for Files    
  1444. Change Folder    
  1445. Create Folder    
  1446. Rename Folder        
  1447. Remove Folder        
  1448. Synchronize Folders    
  1449. Wait for file
  1450.  
  1451.  
  1452. .topic 1160
  1453.  
  1454. Looks for files and creates a file list. This action is useful with pre-defined variables, such as %TextFile(file_name)%. You can create a file list, such as a list of all .Png files, and then use this in a list of actions, such as copying, moving, or deleting files.
  1455.  
  1456. General tab
  1457.  
  1458.  
  1459. Search for Files
  1460. Enter the file path with file mask that you want to search for. Use the Plus buttons to add files or folders to the list. To clear the list, click the X button.
  1461.  
  1462.  
  1463.  
  1464.  
  1465. Exclude Masks (Comma Separated)
  1466. Enter one or more file masks separated with commas that you do not want to search.
  1467.  
  1468.  
  1469.  
  1470.  
  1471. Recurse to Subfolders
  1472. Searches the files in the subfolders of the specified folder.
  1473.  
  1474. Save File List To
  1475. Enter a path and name for a file that contains a list of the files that were searched. Click the List Format tab to set other options for this list.
  1476.  
  1477. Variable
  1478. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1479.  
  1480.  
  1481. Date Filter tab
  1482.  
  1483.  
  1484. All Files
  1485. Select this option to search all files.
  1486.  
  1487. Find Files Created or Modified
  1488. Click this option to search files according to one of the following criteria:
  1489. Between
  1490. Newer Than ___ Months
  1491. Newer Than ___ Days
  1492. Older Than ___ Months
  1493. Older Than ___ Days
  1494.  
  1495. List Format tab
  1496.  
  1497.  
  1498. Without Path Name
  1499. Lists files without the path names (i.e. file names only).
  1500.  
  1501. Insert Text Before
  1502. You can specify a text that will be inserted at the beginning of the list file.
  1503.  
  1504. Insert Text After
  1505. You can specify a text that will be inserted at the end of the list file.
  1506.  
  1507. Insert Text Before Each Line
  1508. You can specify a text that will be inserted at the beginning of each line.
  1509.  
  1510. Insert Text After Each Line
  1511. You can specify a text that will be inserted at the end of each line.
  1512.  
  1513. Variable
  1514. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1515.  
  1516.  
  1517.   Related Topics
  1518. Copy/Move File    
  1519. Rename File    
  1520. Delete File
  1521. Write Text File
  1522. Change Folder    
  1523. Create Folder    
  1524. Rename Folder        
  1525. Remove Folder        
  1526. Synchronize Folders    
  1527. Wait for file
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533. .topic 210
  1534.  
  1535. Allows you to the change the current folder. This is useful if you need to set the current folder during a series of actions or tasks. This action is useful with other file actions like copy, move.
  1536.  
  1537.  
  1538. Folder Name
  1539. Enter the name of the destination folder. You can click the browse button to select a folder.
  1540.  
  1541. Variable
  1542. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1543.  
  1544.  
  1545.   Related Topics
  1546. Copy/Move File    
  1547. Rename File    
  1548. Delete File
  1549. Write Text File
  1550. Search for Files    
  1551. Create Folder    
  1552. Rename Folder        
  1553. Remove Folder        
  1554. Synchronize Folders    
  1555. Wait for file
  1556.  
  1557.  
  1558. .topic 220
  1559.  
  1560. Makes a new folder on a local or remote drive. For example, you could automatically create a new folder for your backups based on the current date.
  1561.  
  1562.  
  1563. New Folder Name
  1564. Enter the name for the new folder. You can click the browse button to select a folder.
  1565.  
  1566. Variable
  1567. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1568.  
  1569.  
  1570.   Related Topics
  1571. Copy/Move File    
  1572. Rename File    
  1573. Delete File
  1574. Write Text File
  1575. Search for Files    
  1576. Change Folder    
  1577. Rename Folder        
  1578. Remove Folder        
  1579. Synchronize Folders    
  1580. Wait for file
  1581.  
  1582.  
  1583.  
  1584. .topic 230
  1585.  
  1586. Renames a existing folder. For example, if you have copied a folder with files, you can rename the original folder.
  1587.  
  1588.  
  1589. Old Folder Name
  1590. Enter the original name of the folder. You can click the browse button to select a folder.
  1591.  
  1592. New Folder Name
  1593. Enter the new name for the folder.
  1594.  
  1595. Variable
  1596. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1597.  
  1598.  
  1599.   Related Topics
  1600. Copy/Move File    
  1601. Rename File    
  1602. Delete File
  1603. Write Text File
  1604. Search for Files    
  1605. Change Folder    
  1606. Create Folder    
  1607. Remove Folder        
  1608. Synchronize Folders    
  1609. Wait for file
  1610.  
  1611.  
  1612. .topic 240
  1613.  
  1614. Deletes a existing folder. For example, if you have archived your company financial reports every week for the past year, you can create a task that automatically deletes folders that are more than a year old.
  1615.  
  1616.  
  1617. Folder Name
  1618. Enter the name of the folder that will be removed.
  1619.  
  1620. Remove Folder if It's Not Empty
  1621. If this option is selected, the specified folder will be deleted even it is not empty (i.e. contains files and subfolders), otherwise the specified folder will be deleted only if it is not empty (i.e. does not contain files and subfolders).
  1622.  
  1623. Variable
  1624. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1625.  
  1626.  
  1627.   Related Topics
  1628. Copy/Move File    
  1629. Rename File    
  1630. Delete File
  1631. Write Text File
  1632. Search for Files    
  1633. Change Folder    
  1634. Create Folder    
  1635. Rename Folder        
  1636. Synchronize Folders    
  1637. Wait for file
  1638.  
  1639.  
  1640. .topic 1170
  1641.  
  1642. Synchronizes the two folders that you specify. The synchronization method may be bi-directional or uni-directional. For example, if you travel a lot, you might want to create a task that synchronizes data in a folder on your laptop computer and a folder on your desktop computer.
  1643.  
  1644.  
  1645. Folder 1
  1646. Enter the first folder that you want to synchronize. You can click the browse button to select a folder.
  1647.  
  1648. Folder 2
  1649. Enter the second folder that you want to synchronize.
  1650.  
  1651. Swap Folders
  1652. Click to place the folder listed in Folder 2 in the Folder 1 box and the folder in Folder 1 in the Folder 2 box.
  1653.  
  1654. Include Masks (Comma Separated)
  1655. Enter one or more masks separated with commas to specify which files to synchronize, such as *.exe, *.cnt, *.hlp. The default  wildcard mask "*.*" means that all folders and files are synchronized. You can specify one or more masks separated by commas.
  1656.  
  1657.  
  1658.  
  1659.  
  1660. Exclude Masks
  1661. Enter one or more masks separated with commas to specify which files to skip in the synchronization. You can specify one or more masks separated by commas; for example, *.bak, *.old, *.$$$.
  1662.  
  1663. How to Synchronize
  1664. Select one of the following options:
  1665. Folder 1 <=> Folder 2 (Bi-directional) - new or newer files that are available in Folder 1 are copied to Folder 1, and vice versa.
  1666. Folder 1 ==> Folder 2 (Uni-directional) - only new or newer files that are available in the Folder 1 are copied to Folder 2; the contents of Folder 2 does not affect the contents of Folder 1.
  1667.  
  1668. Include Subfolders
  1669. Click this check box to synchronize all files in the subfolders.
  1670.  
  1671. Exact Copy in Folder 2
  1672. Available only with unidirectional synchronization when you select Folder 1 ==> Folder 2. This option ensures that files that are available in Folder 2, but not in Folder 1, are deleted.
  1673.  
  1674. Variable
  1675. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1676.  
  1677.  
  1678.   Related Topics
  1679. Copy/Move File    
  1680. Rename File    
  1681. Delete File
  1682. Write Text File
  1683. Search for Files    
  1684. Change Folder    
  1685. Create Folder    
  1686. Rename Folder        
  1687. Remove Folder        
  1688. Wait for file
  1689.  
  1690.  
  1691. .topic 2140
  1692.  
  1693. Pauses the task and waits until the selected file will be available. After the monitored file is been available, the task is resumed. If the specified file is not opened in another process at the moment when the action is due, the task is not paused.
  1694.  
  1695. Wait for file
  1696. You can either select the file name or type its name manually.
  1697.  
  1698. Waiting
  1699. This parameter defines the timeout in seconds to wait until the process is finished. You can also specify an infinite timeout.
  1700. If the timeout is over, but the process is not finished, the action will generate the following error: Timeout is over.
  1701.  
  1702. Variable
  1703. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1704.  
  1705.  
  1706.   Related Topics
  1707. Copy/Move File    
  1708. Rename File    
  1709. Delete File
  1710. Write Text File
  1711. Search for Files    
  1712. Change Folder    
  1713. Create Folder    
  1714. Rename Folder        
  1715. Remove Folder
  1716. Synchronize Folders    
  1717.  
  1718.  
  1719. .topic 1180
  1720.  
  1721. Creates and adds files to zip files. You can use this action to back up your files. For example, you can use this action to create a task that automatically zips weekly status reports files so that they can be copied to the central server for company summary reports every month.
  1722.  
  1723.  
  1724. Files to Zip
  1725. Enter the files you want to add to a zip file. Wildcards are allowed. Use the Plus buttons to add files or folders to the list. To clear the list, click the X button.
  1726.  
  1727.  
  1728.  
  1729.  
  1730. Destination File
  1731. Enter the filename for the resulting .zip archive.
  1732.  
  1733. Action
  1734. Select one of the following actions for creating or adding to the zip file:
  1735. Add and replace files - add all files to the archive.
  1736. Freshen existing files - add only changed files to the archive.
  1737. Move files - add files to the archive and remove them from the local folder.
  1738. Update and add files - add only changed or new files to the archive.
  1739.  
  1740. Compress
  1741. Select one of the items on the dropdown list to determine the level of compression, or size, of the archive file:
  1742. Maximum - creates the smallest zip file possible, while requiring the most time to create the archive.
  1743. Normal -  creates a slightly compressed zip file taking the usual amount of time to create the zip file.
  1744. Fast - produces slightly less compression than Normal.
  1745. Super Fast - produces an archive with even less compression than Fast and Normal.
  1746. None - produces an archive file that is not compressed. This level of compression is the fastest.
  1747.  
  1748. Folders
  1749.  
  1750. Include Subfolders
  1751. Click this check box to include the subfolders in the archive. Files are archived with the paths stored in the archive file.
  1752.  
  1753. Junk Folder Names
  1754. Does not include folder paths in the archive file. For example, if you add C:\documents\*.doc, the .doc files are included into the root folder of the zip archive.
  1755.  
  1756. Store Filenames in 8.3 Format
  1757. Ensures that filenames are stored with the 8.3 name format, such as foo_mon.txt, especially important for FAT file systems.
  1758.  
  1759. Include System and Hidden Files
  1760. Archives system and hidden files in the zip file.
  1761.  
  1762. Password
  1763. Enter a password that is required to unzip the archive, if you want to protect the file.
  1764.  
  1765. Comment
  1766. Enter a memo note for the zip file.
  1767.  
  1768. Variable
  1769. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1770.  
  1771.  
  1772.   Related Topics
  1773. Extract Files    
  1774.  
  1775.  
  1776.  
  1777.  
  1778. .topic 1190
  1779.  
  1780. Extracts files from an existing ZIP file to the folder that you specify. For example, you can create a task that automatically unzips files when you download .zip files to your hard drive.
  1781.  
  1782.  
  1783. File to Unzip
  1784. Enter the name of the zip file to extract files from.
  1785.  
  1786.  
  1787.  
  1788.  
  1789. Destination Folder
  1790. Enter the destination folder where you want to extract files.
  1791.  
  1792. Files to Extract
  1793. Enter the names of the files to unzip from the zip file, separated by commas. If left blank, all files are unzipped.
  1794.  
  1795. Overwrite Existing Files
  1796. Click to allow the extracted files to overwrite existing files with the same name.
  1797.  
  1798. Skip Older Files
  1799. Click to ensure the files in the zip archive are not extracted if they are older than the existing files on the local computer.
  1800.  
  1801. Use Folder Names
  1802. Click this check box to extract files and the directory paths that are archived in the zip file. For example, if a file is zipped with the path \temp\foo.txt, a \temp folder is created in the local directory and the foo.txt file is unzipped to that folder.
  1803.  
  1804. Password
  1805. Enter the password for the zip file, if the zip file is password-protected.
  1806.  
  1807. Variable
  1808. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1809.  
  1810.  
  1811.   Related Topics
  1812. Pack Files    
  1813.  
  1814.  
  1815.  
  1816. .topic 1200
  1817.  
  1818. Checks to see if email exists on a POP3 server that you specify. For example, you can create a task that checks e-mail in the morning and the evening automatically for you, thus minimizing distractions during your work day.
  1819.  
  1820.  
  1821. POP3 Server
  1822. Enter the POP3 server for e-mail.
  1823.  
  1824. Port
  1825. Enter the port number. The default port number is 110.
  1826.  
  1827. Username
  1828. Enter the user name for the e-mail account on the mail server.
  1829.  
  1830. Password
  1831. Enter the password for the e-mail account.
  1832.  
  1833. Stop this Task if
  1834. Enter whether you want the current task to do one of the following before e-mail is downloaded from the mail server:
  1835. Mail is Waiting - stops the task if mail is on the mail server.
  1836. Mail is Not Waiting - stops the task if mail is not on the mail server.
  1837.  
  1838.   Related Topics
  1839. Send Email    
  1840. Download Files
  1841. Ping Host
  1842.  
  1843.  
  1844.  
  1845.  
  1846. .topic 1210
  1847.  
  1848. Sends email through the specified SMTP server. Messages can have attachment files. For example, you can create a task that automatically e-mails monthly invoices to a specific customer outlining the sales charges for that month.
  1849.  
  1850. Message tab
  1851.  
  1852.  
  1853. From
  1854. Enter the e-mail address of the person sending the e-mail.
  1855.  
  1856. To
  1857. Enter the e-mail address to which you are sending the e-mail.
  1858.  
  1859. CC
  1860. Enter the address of any people to which you want to send a courtesy copy.
  1861.  
  1862. Subj
  1863. Enter the subject of the e-mail.
  1864.  
  1865. Message Text
  1866. Enter the text that you want to send. If you enter .html tags, click the Is HTML check box.
  1867.  
  1868. Tip
  1869. You can cut and paste .html code from Notepad into this window with the CTRL+V keys.
  1870.  
  1871. Is HTML
  1872. Click this check box if you have entered .html tags in the Message Text box.
  1873.  
  1874. Attachments
  1875. Click the plus button to add attachments to the e-mail. You can add more than one attachment. Click the X button to remove attachments from the list.
  1876.  
  1877. Variable
  1878. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1879.  
  1880.  
  1881. SMTP Server tab
  1882.  
  1883.  
  1884. Host
  1885. Enter the name of the host to which you want to send the e-mail using SMTP (simple mail transfer protocol).
  1886.  
  1887. Port
  1888. Enter the port number to use.
  1889.  
  1890. Authentication Required
  1891. Click this check box if the remote mail server requires user authentication and enter the user name and password to log into the remote server.
  1892.  
  1893. Variable
  1894. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1895.  
  1896.  
  1897.   Related Topics
  1898. Check for Email
  1899. Download Files
  1900. Ping Host
  1901.  
  1902.  
  1903.  
  1904.  
  1905. .topic 1220
  1906.  
  1907. Downloads one or more files through the Internet from specific Web or FTP sites. For example, if you are participating in a beta test program for new software, you can automatically download updates to the beta software on a daily basis so that you stay up-to-date.
  1908.  
  1909. Important
  1910. Wildcards are not supported.
  1911.  
  1912.  
  1913. Files to Download
  1914. Enter the http, https or ftp URLs that you want to download.
  1915.  
  1916. Save in Folder
  1917. Enter the path of the folder in which you want to save the files.
  1918.  
  1919. If File Exists
  1920. Click an option to determine whether to overwrite existing files with the downloaded file or rename the downloaded file.
  1921. Rename
  1922. Overwrite
  1923.  
  1924. Variable
  1925. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1926.  
  1927.  
  1928.   Related Topics
  1929. Check for Email
  1930. Send Email    
  1931. Ping Host
  1932.  
  1933.  
  1934.  
  1935. .topic 380
  1936.  
  1937. Allows you to send a ping message to a host. This action sends Internet Control Message Protocol (ICMP) Echo Request messages to verify IP-level connectivity to another TCP/IP computer. The action receives a receipt of corresponding Echo Reply messages, along with the round-trip times. Ping Host is based on the Ping command, the primary TCP/IP command used to troubleshoot connectivity, reachability, and name resolution.
  1938.  
  1939. For example, in a backup task, you can use this action to check to see if a host is up before you start a process to copy files to that host.
  1940.  
  1941.  
  1942. Host Name
  1943. Enter the name or IP address of the host.
  1944.  
  1945. Timeout (Msec)
  1946. Indicates the amount of time, in milliseconds, for the action to wait for the Echo Reply message that corresponds to a given Echo Request message to be received. If the Echo Reply message is not received within the time-out, the "Request timed out" error message is displayed.
  1947.  
  1948. Assign Reply Time to Variable (Msec)
  1949. Enter a variable name for the reply time that you want to assign to.
  1950.  
  1951. Assign This Value if Host Does Not Respond
  1952. Enter a value to assign if the host does not respond to the Ping message.
  1953.  
  1954. Variable
  1955. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1956.  
  1957.  
  1958.   Related Topics
  1959. Check for Email
  1960. Send Email    
  1961. Download Files
  1962.  
  1963.  
  1964. .topic 250
  1965.  
  1966. Allows you to log on to an Ftp site, or remote server. For example, you can create a task to automatically Ftp updated daily reports from a co-worker's computer every day.
  1967.  
  1968.  
  1969. Host
  1970. Enter the name of the remote host that you want to log into.
  1971.  
  1972. Port
  1973. Enter the number of the port that you want to use. The default port is 21.
  1974.  
  1975. Authentication
  1976.  
  1977. Connect as Anonymous
  1978. Click this check box if the remote server allows anonymous logins.
  1979.  
  1980. Username
  1981. Enter the name of the log in account.
  1982.  
  1983. Password
  1984. Enter the password of the log in account.
  1985.  
  1986. Variable
  1987. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  1988.  
  1989.  
  1990.   Related Topics
  1991. FTP Log Off    
  1992. FTP Download        
  1993. FTP Upload    
  1994. FTP Rename File    
  1995. FTP Delete File    
  1996. FTP Change Folder    
  1997. FTP Create Folder    
  1998. FTP Remove Folder
  1999. FTP PWD    
  2000. FTP Transfer Type    
  2001. FTP Command
  2002. FTP File Loop    
  2003.  
  2004.  
  2005.  
  2006.  
  2007.  
  2008.  
  2009. .topic 260
  2010.  
  2011. Allows you to log off an Ftp site, or remote server. No specific settings are associated with this action. For example, when you work from home, you can create a task that Ftps daily files that you have worked on to a remote server in your company's network to protect your data.
  2012.  
  2013.   Related Topics
  2014. FTP Log On        
  2015. FTP Download        
  2016. FTP Upload    
  2017. FTP Rename File    
  2018. FTP Delete File    
  2019. FTP Change Folder    
  2020. FTP Create Folder    
  2021. FTP Remove Folder    
  2022. FTP PWD    
  2023. FTP Transfer Type    
  2024. FTP Command
  2025. FTP File Loop    
  2026.  
  2027.  
  2028.  
  2029.  
  2030. .topic 270
  2031.  
  2032. Copies remote files to the local computer using the current file transfer type. For example, if you are participating in a software beta program, you can download daily updates automatically to stay up-to-date.
  2033.  
  2034.  
  2035. Tip
  2036. Click the {V} button to insert a variable that holds the name of the local file or the remote folder.
  2037.  
  2038. Remote File
  2039. Enter the name of the remote file that you want to copy to the local computer.
  2040.  
  2041. Local Folder
  2042. Enter the path and name of the local directory to which you want to copy the remote file.
  2043.  
  2044. Variable
  2045. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  2046.  
  2047.  
  2048.   Related Topics
  2049. FTP Log On        
  2050. FTP Log Off    
  2051. FTP Upload    
  2052. FTP Rename File    
  2053. FTP Delete File    
  2054. FTP Change Folder    
  2055. FTP Create Folder    
  2056. FTP Remove Folder
  2057. FTP PWD    
  2058. FTP Transfer Type    
  2059. FTP Command
  2060. FTP File Loop    
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066. .topic 280
  2067.  
  2068. Allows you to place files on an Ftp site. For example, if you must post daily updated financial reports to a web site, you can create a task to automatically upload the updated reports to the company web site at the end of each day.
  2069.  
  2070.  
  2071. Tip
  2072. Click the {V} button to insert a variable that holds the name of the local file or the remote folder.
  2073.  
  2074. Local File
  2075. Enter the name of the local file that you want to copy to the remote server.
  2076.  
  2077. Remote Folder
  2078. Enter the path and name of the directory on the remote server.
  2079.  
  2080. Variable
  2081. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  2082.  
  2083.  
  2084.   Related Topics
  2085. FTP Log On        
  2086. FTP Log Off    
  2087. FTP Download        
  2088. FTP Rename File    
  2089. FTP Delete File    
  2090. FTP Change Folder    
  2091. FTP Create Folder    
  2092. FTP Remove Folder
  2093. FTP PWD    
  2094. FTP Transfer Type    
  2095. FTP Command
  2096. FTP File Loop    
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103. .topic 290
  2104.  
  2105. Allows you to change the name of files on a remote server. For example, in an FTP session, you can use this action to rename files that you might accidentally overwrite on the remote server with updated files.
  2106.  
  2107.  
  2108. Tip
  2109. Click the {V} button to insert a variable that holds the new file name or the old file name.
  2110.  
  2111. Old File Name
  2112. Enter the name of the file that you want to rename.
  2113.  
  2114. New File Name
  2115. Enter the name that you want to give the file.
  2116.  
  2117. Variable
  2118. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  2119.  
  2120.  
  2121.   Related Topics
  2122. FTP Log On        
  2123. FTP Log Off    
  2124. FTP Download        
  2125. FTP Upload    
  2126. FTP Delete File    
  2127. FTP Change Folder    
  2128. FTP Create Folder    
  2129. FTP Remove Folder
  2130. FTP PWD    
  2131. FTP Transfer Type    
  2132. FTP Command
  2133. FTP File Loop    
  2134.  
  2135.  
  2136.  
  2137.  
  2138. .topic 300
  2139.  
  2140. Allows you to remove files from a remote server. For example, you can use this action to remove old backup files on the remote server that are no longer needed.
  2141.  
  2142.  
  2143. Remote File
  2144. Enter the path and file name that you want to delete on the remote server. Click the {V} button to insert a variable that holds the path and name of the file.
  2145.  
  2146. Variable
  2147. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  2148.  
  2149.  
  2150.   Related Topics
  2151. FTP Log On        
  2152. FTP Log Off    
  2153. FTP Download        
  2154. FTP Upload    
  2155. FTP Rename File    
  2156. FTP Change Folder    
  2157. FTP Create Folder    
  2158. FTP Remove Folderr    
  2159. FTP PWD    
  2160. FTP Transfer Type    
  2161. FTP Command
  2162. FTP File Loop    
  2163.  
  2164.  
  2165.  
  2166.  
  2167. .topic 310
  2168.  
  2169. Allows you to switch the current folder on a remote server. For example, during an FTP task that backs up your files, you can use this action to copy files to different directories on the remote server.
  2170.  
  2171.  
  2172. Remote Folder
  2173. Enter the path or folder name on the remote server that you want to switch to. Click the {V} button to insert a variable that holds the name of the folder.
  2174.  
  2175. Variable
  2176. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  2177.  
  2178.  
  2179.   Related Topics
  2180. FTP Log On        
  2181. FTP Log Off    
  2182. FTP Download        
  2183. FTP Upload    
  2184. FTP Rename File    
  2185. FTP Delete File    
  2186. FTP Create Folder    
  2187. FTP Remove Folder
  2188. FTP PWD    
  2189. FTP Transfer Type    
  2190. FTP Command
  2191. FTP File Loop    
  2192.  
  2193.  
  2194.  
  2195.  
  2196. .topic 320
  2197.  
  2198. Allows you to create a new folder on a remote server. For example, during an FTP task, you can use this action to create a new folder based on the current date for each set of daily backup files.
  2199.  
  2200.  
  2201. Remote Folder
  2202. Enter the path or folder name on the remote server that you want to create. Click the {V} button to insert a variable that holds the name of the folder.
  2203.  
  2204. Variable
  2205. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  2206.  
  2207.  
  2208.   Related Topics
  2209. FTP Log On        
  2210. FTP Log Off    
  2211. FTP Download        
  2212. FTP Upload    
  2213. FTP Rename File    
  2214. FTP Delete File    
  2215. FTP Change Folder    
  2216. FTP Remove Folder    
  2217. FTP PWD    
  2218. FTP Transfer Type    
  2219. FTP Command
  2220. FTP File Loop    
  2221.  
  2222.  
  2223.  
  2224.  
  2225. .topic 330
  2226.  
  2227. Allows you to delete a folder on a remote server. For example, you can create a task to remove company reports that are more than six months old from the remote server.
  2228.  
  2229.  
  2230. Remote Folder
  2231. Enter the path or folder name on the remote server that you want to remove. Click the {V} button to insert a variable that holds the name of the folder.
  2232.  
  2233. Variable
  2234. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  2235.  
  2236.  
  2237.   Related Topics
  2238. FTP Log On        
  2239. FTP Log Off    
  2240. FTP Download        
  2241. FTP Upload    
  2242. FTP Rename File    
  2243. FTP Delete File    
  2244. FTP Change Folder    
  2245. FTP Create Folder    
  2246. FTP PWD    
  2247. FTP Transfer Type    
  2248. FTP Command
  2249. FTP File Loop    
  2250.  
  2251.  
  2252.  
  2253.  
  2254. .topic 340
  2255.  
  2256. Allows you to print the current directory on the remote computer. No specific settings are associated with this action. For example, if you want an automatic print out of company financial reports on a remote server every day, you can use this action.
  2257.  
  2258.   Related Topics
  2259. FTP Log On        
  2260. FTP Log Off    
  2261. FTP Download        
  2262. FTP Upload    
  2263. FTP Rename File    
  2264. FTP Delete File    
  2265. FTP Change Folder    
  2266. FTP Create Folder    
  2267. FTP Remove Folder
  2268. FTP Transfer Type    
  2269. FTP Command
  2270. FTP File Loop    
  2271.  
  2272.  
  2273.  
  2274.  
  2275. .topic 350
  2276.  
  2277. Sets or displays the type of file you are transferring. For example, if you are transferring Microsoft Word reports to the company server every day, you must set the transfer type to binary. The default transfer type is binary.
  2278.  
  2279.  
  2280. Transfer Type
  2281. Select whether you want to transfer the files as ASCII or binary during an FTP session. You should select ASCII when you want to transfer files that contain text strings, such as .html, .txt, or .xml. You should use Binary when transferring executable files, such as Office documents, .Exe files, and so forth. In binary mode, files are transferred in one-byte units.
  2282.  
  2283.   Related Topics
  2284. FTP Log On        
  2285. FTP Log Off    
  2286. FTP Download        
  2287. FTP Upload    
  2288. FTP Rename File    
  2289. FTP Delete File    
  2290. FTP Change Folder    
  2291. FTP Create Folder    
  2292. FTP Remove Folder
  2293. FTP PWD        
  2294. FTP Command
  2295. FTP File Loop    
  2296.  
  2297.  
  2298.  
  2299.  
  2300. .topic 360
  2301.  
  2302. Allows you to execute custom FTP commands.
  2303.  
  2304.  
  2305. Command
  2306. Enter the name of the command that you want to execute.
  2307.  
  2308. Variable
  2309. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  2310.  
  2311.  
  2312.   Related Topics
  2313. FTP Log On        
  2314. FTP Log Off    
  2315. FTP Download        
  2316. FTP Upload    
  2317. FTP Rename File    
  2318. FTP Delete File    
  2319. FTP Change Folder    
  2320. FTP Create Folder    
  2321. FTP Remove Folder
  2322. FTP PWD    
  2323. FTP Transfer Type    
  2324. FTP File Loop    
  2325.  
  2326.  
  2327.  
  2328.  
  2329. .topic 370
  2330.  
  2331. Executes a series of commands on files or folders on a remote server during an FTP session.
  2332.  
  2333. Loop Kind
  2334. Select the items you want to perform actions on: folders only, or files only.
  2335.  
  2336. Remote Folder
  2337. Enter the path or folder name on the remote server.
  2338.  
  2339. Save Results
  2340. Enter information about how you want to save the result of the file loop.
  2341.  
  2342. Assign File Name to Variable
  2343. Click this box and then click the {V} button to assign the file name to that variable. This allows you to use the file name string in other actions or tasks.
  2344.  
  2345. Assign File Size to Variable
  2346. Click this box and then click the {V} button to assign the file size to that variable. This allows you to use the file size data in other actions or tasks.
  2347.  
  2348. Assign Last Update Time to Variable
  2349. Click this box and then click the {V} button to assign the time the file was last updated to that variable. This allows you to use the last update time information in other tasks or actions.
  2350.  
  2351. Variable
  2352. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  2353.  
  2354.  
  2355.   Related Topics
  2356. FTP Log On        
  2357. FTP Log Off    
  2358. FTP Download        
  2359. FTP Upload    
  2360. FTP Rename File    
  2361. FTP Delete File    
  2362. FTP Change Folder    
  2363. FTP Create Folder    
  2364. FTP Remove Folder
  2365. FTP PWD    
  2366. FTP Transfer Type    
  2367. FTP Command    
  2368.  
  2369.  
  2370.  
  2371.  
  2372. .topic 1230
  2373.  
  2374. Establishes or disconnects a Windows RAS connection, also known as Dial Up Networking.  Usually this feature is used to make a connection to the Internet and then complete a task and disconnect from the Internet. For example, you can create a task to automatically connect to the Internet every morning and check e-mail.
  2375.  
  2376.  
  2377. Dial-up Connection
  2378. Select the name of the dial-up connection that you want to connect or disconnect. You create this connection in the Windows Control Panel.
  2379.  
  2380. How to Use the Dial-up Connection
  2381. Select one of the following options to specify the action on the connection:
  2382. Disconnect this Connection - breaks the connection to the Internet or remote network.
  2383. Establish this Connection - connects the computer to the Internet or remote network.
  2384.  
  2385. Connection Parameters
  2386. Enter the following optional parameters to establish a connection:
  2387. Domain
  2388. Username
  2389. Password
  2390. Callback Number
  2391. Number of Attempts
  2392.  
  2393.   Related Topics
  2394. Check connection
  2395.  
  2396.  
  2397. .topic 1750
  2398. Checks the status of the selected dial-up connection and assigns the corresponding value to a user variable: TRUE if the connection is active and FALSE otherwise. This value can be later used in the "IF Then" action as a Boolean one.
  2399.  
  2400. Dial-Up connection
  2401. Select the connection you need from the list.
  2402.  
  2403. Assign Connection Status to Variable
  2404. Specify the name of the variable the status of the connection should be assigned to.
  2405.  
  2406.   Related Topics
  2407. Dial Up/Hang Up
  2408.  
  2409. .topic 390
  2410.  
  2411. Creates a new variable when you run a task. If you create a variable and then use it in several different tasks, you can change the variable once and update every task at the same time.
  2412.  
  2413.  
  2414. Variable Name
  2415. Enter the name of the variable you want to set the value of.
  2416.  
  2417. Variable Value
  2418. Enter the value that you want to set for the variable.
  2419.  
  2420.   Related Topics
  2421. Set Variable    
  2422. Remove Variable
  2423. Increment Variable
  2424. Delimited variable
  2425.  
  2426.  
  2427. .topic 400
  2428.  
  2429. Defines the value of a variable when you run a task.
  2430.  
  2431.  
  2432. Variable Name
  2433. Enter the name of the variable you want to set the value of.
  2434.  
  2435. Variable Value
  2436. Enter the value that you want to set for the variable.
  2437.  
  2438.   Related Topics
  2439. Create Variable
  2440. Remove Variable
  2441. Increment Variable
  2442. Delimited variable
  2443.  
  2444.  
  2445.  
  2446. .topic 410
  2447.  
  2448. Deletes a variable when you run a task. This ensures that all variables are cleared from memory if a new task starts.
  2449.  
  2450.  
  2451. Variable Name
  2452. Enter the name of the variable you want to delete.
  2453.  
  2454.   Related Topics
  2455. Create Variable
  2456. Set Variable    
  2457. Increment Variable
  2458. Delimited variable
  2459.  
  2460. .topic 1660
  2461.  
  2462. Increments or decrements a variable by a specified value.
  2463.  
  2464. Variable Name
  2465. Specify a variable name you want to increment or decrement
  2466.  
  2467. Increment by
  2468. Enter a positive or negative value
  2469.  
  2470. Variable
  2471. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  2472.  
  2473.  
  2474.   Related Topics
  2475. Create Variable
  2476. Set Variable    
  2477. Remove Variable
  2478. Delimited variable
  2479.  
  2480. .topic 1760
  2481. Turns a string with any delimiters into a standard comma-separated string. This standard comma-separated string can be used in user variables as an array.
  2482.  
  2483. String to process
  2484. Specify the string to process. You can use variables.
  2485.  
  2486. Delimiters
  2487. Select which delimiters should be processed. You can select one or several delimiters.
  2488.  
  2489. Quote Char
  2490. Specify the character that should be interpreted as quotation marks.
  2491.  
  2492. Assign standard comma-separated text to variable
  2493. Specify the variable the processed string should be assigned to.
  2494.  
  2495. Variable
  2496. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  2497.  
  2498.  
  2499.   Related Topics
  2500. Create Variable
  2501. Set Variable    
  2502. Remove Variable
  2503. Increment Variable
  2504.  
  2505. .topic 420
  2506.  
  2507. Enables a task. Disabled tasks cannot run automatically, i.e. their triggering events are disabled.
  2508.  
  2509.  
  2510. Task
  2511. Select a existing task.
  2512.  
  2513.   Related Topics
  2514. Disable Task    
  2515. Start Task
  2516. Stop Task
  2517. Wait for Task
  2518.  
  2519.  
  2520.  
  2521.  
  2522. .topic 430
  2523.  
  2524. Disables a task. Disabled tasks cannot run automatically, i.e. their triggering events are disabled.
  2525.  
  2526.  
  2527. Task
  2528. Select a existing task.
  2529.  
  2530.   Related Topics
  2531. Enable Task
  2532. Start Task
  2533. Stop Task
  2534. Wait for Task
  2535.  
  2536.  
  2537.  
  2538.  
  2539. .topic 1240
  2540.  
  2541. Runs a task. This action is useful if you want to run several tasks in a series. For example, you can create several different tasks in a series based on certain conditions that are detected in the following order:
  2542.  
  2543. 1.    A task that connects to the Internet and checks the e-mail server,
  2544. 2.    A task that logs off if no e-mail is present,
  2545. 3.    A task that displays a message box if you have received e-mail.
  2546.  
  2547.  
  2548. Task
  2549. Select a existing task.
  2550.  
  2551. Wait for Finish
  2552. Click this check box to ensure that the Start Task action starts a task and waits for completion of that task, then continues running. If the check box is clear, the action starts a task and continues running immediately.
  2553.  
  2554.   Related Topics
  2555. Enable Task
  2556. Disable Task
  2557. Stop Task
  2558. Wait for Task    
  2559.  
  2560. .topic 1610
  2561.  
  2562. Allows you to stop the selected task.
  2563.  
  2564. Task
  2565. Select the task you need from the list.
  2566.  
  2567.   Related Topics
  2568. Enable Task
  2569. Disable Task    
  2570. Start Task
  2571. Wait for Task
  2572.  
  2573.  
  2574. .topic 1620
  2575.  
  2576. Waits until the selected task is finished. This actions pauses the current task until the selected task is finished. If the selected task in not running at the moment when the action is due, the current task is not paused.
  2577. If the selected task is not finished during the specified timeout, the "Timeout is over" error is generated.
  2578.  
  2579. Task
  2580. Select a task from the list.
  2581.  
  2582. Waiting
  2583. Specify the timeout in seconds to wait for the task to be finished. You can also specify an infinite timeout.
  2584.  
  2585.   Related Topics
  2586. Enable Task
  2587. Disable Task    
  2588. Start Task
  2589. Stop Task
  2590.  
  2591. .topic 440
  2592.  
  2593. Allows a task to iterate through the results of a file search. For example, you can create a task that searches all the employee status reports and identifies all status report files for the first of the month.
  2594.  
  2595. General tab
  2596.  
  2597.  
  2598. Search for Files
  2599. Enter the files that you want to include in the loop. You can click the browse buttons to the right of the list to add files, add folders, and remove items from the list.
  2600.  
  2601.  
  2602.  
  2603.  
  2604. Exclude Masks (Comma Separated)
  2605. Enter one or more file masks separated by commas for files that you do not want to include in the loop.
  2606.  
  2607.  
  2608.  
  2609.  
  2610. Recurse to Subfolders
  2611. Click this check box to include subfolders in the loop.
  2612.  
  2613. Assign Current Filename to Variable
  2614. The current filename and path to the file in the loop is stored in the variable that you specify. You can use this information in other actions.
  2615.  
  2616. Without Full Path
  2617. Click this check box to save only the filename and not the path to the variable.
  2618.  
  2619. Assign File Size to Variable
  2620. The current file size in the loop is assigned to the variable that you specify. You can use this information in other actions.
  2621.  
  2622. Assign File Time to Variable
  2623. The current time of the file in the loop is assigned to the variable that you specify. You can use this information in other actions.
  2624.  
  2625. Variable
  2626. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  2627.  
  2628. Data Filter tab
  2629.  
  2630.  
  2631. All Files
  2632. Click this option to include all files in the file loop.
  2633.  
  2634. Find Files Created or Modified
  2635. Enter dates and times to include files for certain time periods in the loop.
  2636. Between
  2637. Newer Than ___ Months
  2638. Newer Than ___ Days
  2639. Older Than ___ Months
  2640. Older Than ___ Days
  2641.  
  2642. Variable
  2643. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  2644.  
  2645.  
  2646.   Related Topics
  2647. Text Loop    
  2648. Dataset Loop    
  2649. Simple Loop    
  2650. End Loop    
  2651. Break    
  2652. Continue    
  2653. If Then        
  2654. Else    
  2655. End If
  2656.  
  2657.  
  2658.  
  2659.  
  2660. .topic 450
  2661.  
  2662. Allows a task to iterate through all lines of the text that you specify. You can enter text in the parameters of the action or you can refer to a text file.
  2663.  
  2664.  
  2665. External Text File
  2666. Enter the path and name of text file or click the browse button to select a text file.
  2667.  
  2668. Specified Text
  2669. Enter the text you want to loop through.
  2670.  
  2671. Store Current Line to Variable
  2672. Enter a variable name to store with the current line of text.
  2673.  
  2674. Variable
  2675. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  2676.  
  2677.  
  2678.   Related Topics
  2679. File Loop    
  2680. Dataset Loop    
  2681. Simple Loop    
  2682. End Loop    
  2683. Break    
  2684. Continue    
  2685. If Then        
  2686. Else    
  2687. End If
  2688.  
  2689.  
  2690.  
  2691.  
  2692. .topic 460
  2693.  
  2694. Allows a task to iterate through the values of the results of an SQL query.  For example, you might create a task that connects to the company human resources database and queries for all records of employee sick leave reports every month and saves a report to a file.
  2695.  
  2696. Important
  2697. You must be familiar with SQL syntax to use this action.
  2698.  
  2699.  
  2700. Connection String
  2701. A string with attribute/value pairs for information required to log on to a database and point to a specific database. Click the browse button to open the Microsoft Data Link Properties dialog box. You can press F1 to access Help about this dialog box.
  2702.  
  2703. SQL Query
  2704. Enter the query string in SQL syntax.
  2705.  
  2706. Assign Field Names to Variable
  2707. Stores the field names separated by commas in a specified variable.
  2708.  
  2709. Assign Field Values to Variable
  2710. Stores the field values separated by commas in a specified variable.
  2711.  
  2712. With Memo Fields
  2713. Specifies that the query should include memo fields.
  2714.  
  2715. Store Memos as "Comma Text"
  2716. Indicates that the memo fields should be stored as comma delimited text.
  2717.  
  2718. Variable
  2719. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  2720.  
  2721.  
  2722. Test SQL
  2723. Allows you to test the SQL syntax of your query.
  2724.  
  2725.   Related Topics
  2726. File Loop    
  2727. Text Loop    
  2728. Simple Loop    
  2729. End Loop    
  2730. Break    
  2731. Continue    
  2732. If Then        
  2733. Else    
  2734. End If
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740. .topic 1770
  2741.  
  2742. Enumerates windows existing in the system and allows you to assign their parameters to variables. You can use these values inside the loop.
  2743.  
  2744. General
  2745.  
  2746. Assign Window Caption to variable
  2747. You can specify the variable you want to assign the window caption to. If you clear this checkbox, the window caption will not be saved.
  2748.  
  2749. Assign Window Class to variable
  2750. You can specify the variable you want to assign the window class to. If you clear this checkbox, the window class will not be saved.
  2751.  
  2752. Assign Window Handle to variable
  2753. Specify the variable you want to assign the window handle to. You cannot disable this option because the handle of a window is its unique identifier. You can use the value of this variable in the "Window Command" action.
  2754.  
  2755. Window Filters
  2756.  
  2757. Process Hidden Windows
  2758. If you want to enumerate hidden windows, you should select this checkbox. By default, Window loop enumerates only visible windows.
  2759.  
  2760. Process Child Windows
  2761. Select this checkbox to enumerate child windows.
  2762.  
  2763. Window caption
  2764. You can use this parameter to apply a filter to the captions of windows. Either select the caption you need from the list or type it manually.
  2765.  
  2766. Window class
  2767. You can use this parameter to apply a filter to the classes of windows. Either select the class you need from the list or type it manually.
  2768. The "Window caption" and "Window class" lists depend on the "Process Hidden Windows" and "Process Child Windows" checkboxes.
  2769.  
  2770. Variable
  2771. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  2772.  
  2773.  
  2774.   Related Topics
  2775. File Loop
  2776. Text Loop    
  2777. Dataset Loop    
  2778. Simple Loop    
  2779. End Loop    
  2780. Break    
  2781. Continue    
  2782. If Then        
  2783. Else    
  2784. End If
  2785.  
  2786.  
  2787.  
  2788.  
  2789. .topic 470
  2790.  
  2791. Allows a task to iterate through a loop.
  2792.  
  2793.  
  2794. Start From
  2795. Enter the number at which to start the loop.
  2796.  
  2797. To
  2798. Enter the number at which to end the loop.
  2799.  
  2800. Destination Variable
  2801. Stores the current value of the loop. For example, if you enter 1 in the Start From box and 5 in the To box, then, in the first iteration, the destination variable contains 1. In the second iteration, the destination variable contains 2, and so forth.
  2802.  
  2803.   Related Topics
  2804. File Loop    
  2805. Text Loop    
  2806. Dataset Loop    
  2807. End Loop    
  2808. Break    
  2809. Continue    
  2810. If Then        
  2811. Else    
  2812. End If
  2813.  
  2814.  
  2815.  
  2816.  
  2817. .topic 480
  2818.  
  2819. Indicates the end of the loop block. Any loop, including a file loop, simple loop, and so forth, must contain the corresponding End Loop action.
  2820.  
  2821.   Related Topics
  2822. File Loop    
  2823. Text Loop    
  2824. Dataset Loop    
  2825. Simple Loop    
  2826. Break    
  2827. Continue    
  2828. If Then        
  2829. Else    
  2830. End If
  2831.  
  2832.  
  2833.  
  2834.  
  2835. .topic 490
  2836.  
  2837. Stops the execution of the current loop so that the task can continue executing the actions after the End Loop action. The Break action is often used in conjunction with the If Then action.
  2838.  
  2839.   Related Topics
  2840. File Loop    
  2841. Text Loop    
  2842. Dataset Loop    
  2843. Simple Loop    
  2844. End Loop    
  2845. Continue    
  2846. If Then        
  2847. Else    
  2848. End If
  2849.  
  2850.  
  2851.  
  2852.  
  2853. .topic 500
  2854.  
  2855. Skips all the actions between it and the End Loop action and begins a new iteration. No specific settings are associated with this action. The Continue action is used in conjunction with the If Then action.
  2856.  
  2857.  
  2858.   Related Topics
  2859. File Loop    
  2860. Text Loop    
  2861. Dataset Loop    
  2862. Simple Loop    
  2863. End Loop    
  2864. Break    
  2865. If Then        
  2866. Else    
  2867. End If
  2868.  
  2869.  
  2870.  
  2871. .topic 510
  2872.  
  2873. Allows a task to make a comparison of several conditions and execute actions based on that comparison.  You can use this action to run a specific statement or a block of statements, depending on the value of a condition. If...Then...Else statements can be nested to as many levels as you need.
  2874.  
  2875. Important
  2876. The If Then action must be used in conjunction with the End If action.
  2877.  
  2878.  
  2879. Compare Values As
  2880. Select the type of data for the expressions that you want to compare.
  2881. As String - compares two values with alphanumeric characters.
  2882. As Number - compares two integer values.
  2883. As Date and Time - compares two date/time values.
  2884. As Boolean - checks for a true/false or yes/no condition. If you select this option, the If Value Is option appears, allowing you to select the condition of the Boolean.
  2885.  
  2886. If Value Is
  2887. Appears if you select As Boolean in the Compare Values As area. This option allows you to set the value of the Boolean check. You can select false for certain actions to occur if a condition does not exist. You can select true for certain actions to occur if a condition does exist.
  2888.  
  2889. First Operand
  2890. Enter the value of the first expression you want to compare.
  2891.  
  2892. Comparison Type
  2893. Select the operator for the comparison from the following:
  2894. = Equal to
  2895. <> Not equal
  2896. >= More than or equal to
  2897. > More
  2898. <= Less than or equal to
  2899. < Less than
  2900.  
  2901. Case Sensitive
  2902. Click to make the comparison dependent on whether upper case or lower case characters are used in the expressions.
  2903.  
  2904. Second Operand
  2905. Enter the value of the second expression you want to compare.
  2906.  
  2907. Variable
  2908. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  2909.  
  2910.  
  2911.   Related Topics
  2912. File Loop    
  2913. Text Loop    
  2914. Dataset Loop    
  2915. Simple Loop    
  2916. End Loop    
  2917. Break    
  2918. Continue    
  2919. Else    
  2920. End If
  2921.  
  2922.  
  2923.  
  2924. .topic 520
  2925.  
  2926. Allows a task to execute an action if certain conditions are not met. This action is used in conjunction with the If Then action. You can use this action to run a specific statement or a block of statements, depending on the value of a condition. If...Then...Else statements can be nested to as many levels as you need. No specific settings are associated with this action.
  2927.  
  2928.   Related Topics
  2929. File Loop    
  2930. Text Loop    
  2931. Dataset Loop    
  2932. Simple Loop    
  2933. End Loop    
  2934. Break    
  2935. Continue    
  2936. If Then        
  2937. End If
  2938.  
  2939.  
  2940.  
  2941.  
  2942. .topic 530
  2943.  
  2944. Indicates the end of the If Then block.
  2945.  
  2946.   Related Topics
  2947. File Loop    
  2948. Text Loop    
  2949. Dataset Loop    
  2950. Simple Loop    
  2951. End Loop    
  2952. Break    
  2953. Continue    
  2954. If Then        
  2955. Else    
  2956.  
  2957.  
  2958.  
  2959.  
  2960. .topic 1250
  2961.  
  2962. Manipulates certain windows that you specify.
  2963.  
  2964.  
  2965. Window Caption
  2966. Enter or select the caption of the window that you want to manipulate with the action you select in the Action list. You can enter part of a window caption.
  2967.  
  2968. Caption Must Match Exactly
  2969. Select this check box if you want to manipulate only the window that exactly matches the window caption you selected. This check box is cleared by default so that the task can manipulate windows that contain only part of the window caption entered in the Window Caption box. For example, you can enter <notepad> for the window with a caption <Untitled - Notepad>.
  2970.  
  2971. Action
  2972. Select the action for manipulating the window.
  2973. Focus - makes the window active.
  2974. Minimize - reduces the window to an icon on the Windows taskbar.
  2975. Maximize - restores the window to fill the entire screen.
  2976. Restore - restores the window to its previous state.
  2977. Close - closes the window.
  2978. Hide - hides the window from view on the screen and Windows taskbar.
  2979. Unhide  - displays the hidden window.
  2980.  
  2981.   Related Topics
  2982. Check for Window
  2983.  
  2984.  
  2985.  
  2986.  
  2987. .topic 1260
  2988.  
  2989. Checks to see if a window exists or is active. For example, you might want to create a task that starts your HotSync Manager for your Palm PDA every day and synchronizes the Palm device data with Outlook. You might want to check for the existence of the HotSync Manager window to ensure that it has started.
  2990.  
  2991.  
  2992. Window Caption
  2993. Select the name of the window from the dropdown list. The contents of this list vary with the applications currently launched on your computer.
  2994.  
  2995. Caption Must Match Exactly
  2996. Click the check box to check only windows that match the entire window caption. If this check box is clear, the action checks for windows that partially match the caption.
  2997.  
  2998. Check For
  2999. Select one of the following options to check for existing windows or windows that are open.
  3000.  
  3001. Window Exist
  3002. Window Active
  3003.  
  3004. Abort Task If
  3005. Stops task executing according with selected option:
  3006.  
  3007. Window Not Exists/Active - stops the task if the window does not exist or is not active.
  3008. Window Exist/Active - stops the task if the window exists or is active.
  3009.  
  3010.  
  3011.   Related Topics
  3012. Window Command    
  3013.  
  3014.  
  3015.  
  3016.  
  3017. .topic 1270
  3018.  
  3019. Important
  3020. This action is available only on Windows NT 4, 2000, and XP.
  3021.  
  3022. Starts a service already installed on the local or remote NT server or workstation. A service is a special process that can be launched during operating system boot. The most important feature of a service is that you do not have to log on to the computer.
  3023.  
  3024. A service is started in the Local System account. You can start an existing service or a service that you created. Examples of services include FTP/HTTP servers, print spoolers, file sharing, and so forth.
  3025.  
  3026. Usually, Windows services do have not a user interface, but are managed through the Services applet of the Windows Control Panel, or a separate application or applet. Using the standard Services applet, you can start, stop, pause, or continue a previously installed service. The common way for a service to report a warning or error is recording an event into the system event log. You can review the log using the Event Viewer from Administrative Tools in Windows.
  3027.  
  3028.  
  3029. Computer Name
  3030. Enter the remote computer name. If you want to start a service on the local computer, use {ComputerName}. You can click the browse button to select a computer from the local area network.
  3031.  
  3032. Service
  3033. Select a service that you want to stop from the dropdown list. The items on this list depend on which services are present on the computer.
  3034.  
  3035. Parameters
  3036. Specify optional parameters for the service that you want to start.
  3037.  
  3038. Refresh
  3039. Click this button to refresh the Service list.
  3040.  
  3041. Variable
  3042. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  3043.  
  3044.  
  3045.   Related Topics
  3046. Stop Service        
  3047. Lock Workstation
  3048.  
  3049.  
  3050.  
  3051. .topic 1280
  3052.  
  3053. Important
  3054. This action is available only on Windows NT 4, 2000, and XP.
  3055.  
  3056. Stops a service already installed and started on the local or remote server or workstation. For more information, see Start Service.
  3057.  
  3058.  
  3059. Computer Name
  3060. Enter the remote computer name. If you want to start a service on the local computer, use {ComputerName}. You can click the browse button to select a computer from the local area network.
  3061.  
  3062. Service
  3063. Select a service that you want to stop from the dropdown list. The items on this list depend on which services are present on the local computer.
  3064.  
  3065. Refresh
  3066. Click this button to refresh the Service list.
  3067.  
  3068. Variable
  3069. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  3070.  
  3071.  
  3072.   Related Topics
  3073. Start Service
  3074. Lock Workstation
  3075.  
  3076.  
  3077.  
  3078. .topic 540
  3079.  
  3080. This action submits a request to lock the workstation's display. Locking a workstation protects it from unauthorized use.
  3081.  
  3082.   Related Topics
  3083. Start Service
  3084. Stop Service        
  3085.  
  3086. .topic 550
  3087.  
  3088. Collapses the RoboTask window and displays the RoboTask icon on the Windows Taskbar. No specific settings are associated with this action.
  3089.  
  3090. This action is useful if you do not want RoboTask to appear on the computer while the task runs.
  3091.  
  3092.   Related Topics
  3093. Restore RoboTask    
  3094. Exit RoboTask
  3095. Enable Automation    
  3096. Disable Automation    
  3097. Log Message
  3098.  
  3099.  
  3100.  
  3101.  
  3102. .topic 560
  3103.  
  3104. Activates RoboTask and displays the RoboTask window on the computer screen. No specific settings are associated with this action.
  3105.  
  3106. This action is useful for system administrators who want to troubleshoot a process. For example, if a "critical error" occurs, you can use the Disable Automation action, trap an error message with the message box, and then use the Restore RoboTask action.
  3107.  
  3108.   Related Topics
  3109. Minimize RoboTask    
  3110. Exit RoboTask
  3111. Enable Automation    
  3112. Disable Automation    
  3113. Log Message
  3114.  
  3115.  
  3116.  
  3117. .topic 570
  3118.  
  3119. Closes RoboTask. No specific settings are associated with this action.
  3120.  
  3121.   Related Topics
  3122. Minimize RoboTask    
  3123. Restore RoboTask    
  3124. Enable Automation    
  3125. Disable Automation    
  3126. Log Message
  3127.  
  3128.  
  3129.  
  3130.  
  3131. .topic 580
  3132.  
  3133. Enables task triggering. If task triggering is disabled, the tasks will not run automatically, i.e. all your tasks are disabled. You may run tasks only manually.
  3134.  
  3135.  
  3136.   Related Topics
  3137. Minimize RoboTask    
  3138. Restore RoboTask    
  3139. Exit RoboTask
  3140. Disable Automation    
  3141. Log Message
  3142.  
  3143.  
  3144.  
  3145.  
  3146. .topic 590
  3147.  
  3148. Disables task triggering. If task triggering is disabled, the tasks will not run automatically, i.e. all your tasks are disabled. You may run tasks only manually.
  3149.  
  3150.  
  3151.   Related Topics
  3152. Minimize RoboTask    
  3153. Restore RoboTask    
  3154. Exit RoboTask
  3155. Enable Automation    
  3156. Log Message
  3157.  
  3158.  
  3159.  
  3160.  
  3161. .topic 600
  3162.  
  3163. Records a message to the task's log. This action is a powerful tool for recording the results of actions when they occur in a log text file. This action is useful for system administrators who want to troubleshoot a process.
  3164.  
  3165. The log filename is based on the internal unique ID number of the task. Each task has an internal unique ID number and its filename is NNNNNNNN.tsk where NNNNNNNN is its ID number. The log file name is NNNNNNNN.log.
  3166.  
  3167. Important
  3168. You can set options for logging on the Advanced tab of the Add Task dialog box or the Edit Task dialog box.
  3169.  
  3170.  
  3171. Message Text
  3172. Enter the text that you want to appear in the message.
  3173.  
  3174. Message Type
  3175. Select a type, such as Information, Warning, or Message. The type determines the style of log message:
  3176. Information - a blue text and "i" icon appears.
  3177. Warning - an olive text and "!" icon.
  3178. Error - a red text and "X" icon.
  3179.  
  3180. Variable
  3181. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  3182.  
  3183.  
  3184.   Related Topics
  3185. Minimize RoboTask    
  3186. Restore RoboTask    
  3187. Exit RoboTask
  3188. Enable Automation    
  3189. Disable Automation    
  3190.  
  3191.  
  3192.  
  3193.  
  3194. .topic 1810
  3195.  
  3196. Cuts the selected text fragment (image) into the system clipboard from the active Windows application.
  3197.  
  3198. Do it byà
  3199. There are two ways to cut a fragment:
  3200. 1.    by sending a Windows message to the corresponding edit element
  3201. 2.    by emulating the key combination
  3202.  
  3203. It is recommended to use the second method because it is a universal mechanism for any application and any data type.
  3204.  
  3205.   Related Topics
  3206. Copy
  3207. Paste
  3208. Clear Clipboard
  3209. Get text
  3210. Put Text
  3211.  
  3212.  
  3213. .topic 1820
  3214.  
  3215. Copies the selected text fragment (image) into the system clipboard from the active Windows application.
  3216.  
  3217. Do it byà
  3218. There are two ways to copy a fragment:
  3219. 1.    by sending a Windows message to the corresponding edit element
  3220. 2.    by emulating the key combination
  3221.  
  3222. It is recommended to use the second method because it is a universal mechanism for any application and any data type.
  3223.  
  3224.   Related Topics
  3225. Cut
  3226. Paste
  3227. Clear Clipboard
  3228. Get text
  3229. Put Text
  3230.  
  3231.  
  3232.  
  3233. .topic 1830
  3234.  
  3235. Pastes the copied fragment from the system clipboard to the current Windows application.
  3236.  
  3237. Do it byà
  3238. There are two ways to paste a fragment:
  3239. 1.    by sending a Windows message to the corresponding edit element
  3240. 2.    by emulating the key combination
  3241.  
  3242. It is recommended to use the second method because it is a universal mechanism for any application and any data type.
  3243.  
  3244.   Related Topics
  3245. Cut
  3246. Copy
  3247. Clear Clipboard
  3248. Get text
  3249. Put Text
  3250.  
  3251.  
  3252.  
  3253. .topic 1840
  3254.  
  3255. Clears the system clipboard. It has no parameters.
  3256.  
  3257.   Related Topics
  3258. Cut
  3259. Copy
  3260. Paste
  3261. Get text
  3262. Put Text
  3263.  
  3264.  
  3265.  
  3266. .topic 1850
  3267.  
  3268. Assigns the text from the system clipboard to a variable. If the clipboard contains a graphic object or an object of some other type that cannot be converted into text, an empty string will be assigned to the variable.
  3269.  
  3270. Assign Clipboard Content to variable
  3271. Specify the variable the text from the system clipboard should be assigned to.
  3272.  
  3273.   Related Topics
  3274. Cut
  3275. Copy
  3276. Paste
  3277. Clear Clipboard
  3278. Put Text
  3279.  
  3280.  
  3281.  
  3282. .topic 1860
  3283.  
  3284. Copies the specified text into the system clipboard. You can take text from a file or type it directly in the "Specified text" field. User and system RoboTask variables can be used.
  3285.  
  3286. External Text File
  3287. Specify the name of the file to take the text from.
  3288.  
  3289. Specified Text
  3290. Type the fragment that should be copied into the clipboard.
  3291.  
  3292. Variable
  3293. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  3294.  
  3295.  
  3296.   Related Topics
  3297. Cut
  3298. Copy
  3299. Paste
  3300. Clear Clipboard
  3301. Get text
  3302.  
  3303.  
  3304.  
  3305.  
  3306. .topic 1900
  3307.  
  3308. Moves the mouse pointer to the specified object. You can select a control element in a window (button, menu, toolbar, etc.) or a window as an object.
  3309.  
  3310. To make editing this parameter more comfortable, you can drag the message "Drag this text to desired control" to the object you need. While you are moving the mouse pointer, elements recognized by RoboTask are highlighted with a frame. After you release the left mouse button, all the parameters are specified automatically depending on the position of the mouse pointer. After that you can edit the parameter manually if necessary.
  3311.  
  3312. Window caption
  3313. Specify the window caption completely or any part of it. If the caption does not matter, leave the field blank.
  3314.  
  3315. Window caption must match exactly
  3316. If you need the caption to match exactly the specified caption, select this checkbox. If you do not need the exact match, you can specify any part of the window caption.
  3317.  
  3318. Window class
  3319. Specify the window class completely. If the class does not matter, leave the field blank.
  3320.  
  3321. Control Text
  3322. Specify the text of the window control element completely or partially.
  3323.  
  3324. Control Text must match exactly
  3325. If you need the control text to match exactly the specified text, select this checkbox. If you do not need the exact match, you can specify any part of the control element text.
  3326.  
  3327. Control class
  3328. Specify the control class completely. If the class does not matter, leave the field blank.
  3329.  
  3330. Control position
  3331. Specify the coordinates of the control element. The values are specified relatively to the window. The coordinates of the control are necessary in order to identify the control element because the window may contain several elements with the same Control Text and Control Class.
  3332.  
  3333. Mouse Cursor Position
  3334. Specify the position of the mouse pointer relatively to the control element.
  3335.  
  3336. Variable
  3337. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  3338.  
  3339.  
  3340.   Related Topics
  3341. Click
  3342. Move
  3343.  
  3344. .topic 1910
  3345.  
  3346. Emulates a mouse click in the current position.
  3347.  
  3348. Button
  3349. Select the mouse button:
  3350. Left Button
  3351. Right Button
  3352. Middle Button.
  3353.  
  3354. Action
  3355. Select the action. There are 4 variants to choose from:
  3356. Click
  3357. Double Click
  3358. Button Down
  3359. Button release
  3360.  
  3361.  
  3362.   Related Topics
  3363. Move to object
  3364. Move
  3365.  
  3366.  
  3367. .topic 1920
  3368.  
  3369. Moves the mouse pointer the specified distance away from the current position or to the specified point.
  3370.  
  3371. Coordinates mode
  3372. Coordinates: absolute or relative.
  3373. Absolute coordinate - the absolute coordinates of a point on the screen will be specified in the next parameter.
  3374. Relative coordinates - the coordinates of a point on the screen relative to the current position of the mouse pointer will be specified in the next parameter.
  3375.  
  3376. Absolute or Relative coordinates
  3377. The coordinates of a point where the mouse pointer should be moved. The type of coordinates is determined by the previous parameter.
  3378.  
  3379. In order to set the coordinates interactively, you should drag the text in the upper part of the dialog box to the necessary point on the screen. The coordinate values will be specified automatically.
  3380.  
  3381.   Related Topics
  3382. Move to object
  3383. Click
  3384.  
  3385.  
  3386. .topic 1980
  3387.  
  3388. Adds a key (branch) to the registry.
  3389.  
  3390. Key Name
  3391. Name of the key to be added. You can use the dialog box to select the key interactively; to open it click the button to the right of the text box.
  3392.  
  3393. Variable
  3394. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  3395.  
  3396.  
  3397.   Related Topics
  3398. Delete Key
  3399. Rename Key
  3400. Read Value
  3401. Write Value
  3402. Delete value
  3403. Rename value
  3404. Export
  3405. Import
  3406.  
  3407. .topic 1990
  3408.  
  3409. Deletes the specified key (branch) from the registry. The specified key will be deleted together with all its subkeys and entries.
  3410.  
  3411. Key Name
  3412. Name of the key to be deleted. You can use the dialog box to select the key interactively; to open it click the button to the right of the text box.
  3413.  
  3414. Variable
  3415. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  3416.  
  3417.  
  3418.   Related Topics
  3419. Add key
  3420. Rename Key
  3421. Read Value
  3422. Write Value
  3423. Delete value
  3424. Rename value
  3425. Export
  3426. Import
  3427.  
  3428.  
  3429. .topic 2000
  3430.  
  3431. Renames the specified key (branch) of the registry
  3432.  
  3433. Key Name
  3434. Name of the key to be renamed. You can use the dialog box to select the key interactively; to open it click the button to the right of the text box.
  3435.  
  3436. New Key Name
  3437. A new name that will be given to the specified key.
  3438.  
  3439. Variable
  3440. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  3441.  
  3442.  
  3443.   Related Topics
  3444. Add key
  3445. Delete Key
  3446. Read Value
  3447. Write Value
  3448. Delete value
  3449. Rename value
  3450. Export
  3451. Import
  3452.  
  3453.  
  3454. .topic 2010
  3455.  
  3456. Read the specified value from the registry and assign it to the user variable. This action allows reading values of String and Integer types only.
  3457.  
  3458. Key Name
  3459. Full path to the value you want to read. You can use the dialog box to select the key and value interactively; to open it click the button to the right of the text box. When you click the OK button, the "Key Name" and "Value Name" fields will be filled, if you have selected the necessary value.
  3460.  
  3461. Value Name
  3462. Name of the value to be read. If you leave Value Name empty, RoboTask will read the default value of the key.
  3463.  
  3464. Assign to Variable
  3465. Name of the user variable that should be assigned the value we have read.
  3466.  
  3467. Variable
  3468. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  3469.  
  3470.  
  3471.   Related Topics
  3472. Add key
  3473. Delete Key
  3474. Rename Key
  3475. Write Value
  3476. Delete value
  3477. Rename value
  3478. Export
  3479. Import
  3480.  
  3481.  
  3482. .topic 2020
  3483.  
  3484. Write the value to the specified key in the registry. This action allows writing values of String and Integer types only.
  3485.  
  3486. Key Name
  3487. Full path to the value you'd like to write. You can use the dialog box to select the key and value interactively; to open it click the button to the right of the text box. When you click the OK button, the "Key Name" and "Value Name" fields will be filled, if you have selected the necessary value.
  3488.  
  3489. Value Name
  3490. Name of the value to be written.
  3491.  
  3492. Value Type
  3493. Select the type of value to be written: String or Integer.
  3494.  
  3495. Value
  3496. The value to be written.
  3497.  
  3498. Variable
  3499. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  3500.  
  3501.  
  3502.   Related Topics
  3503. Add key
  3504. Delete Key
  3505. Rename Key
  3506. Read Value
  3507. Delete value
  3508. Rename value
  3509. Export
  3510. Import
  3511.  
  3512.  
  3513. .topic 2030
  3514.  
  3515. Deletes the specified value from the registry.
  3516.  
  3517. Key Name
  3518. Full path to the value you'd like to delete. You can use the dialog box to select the key and value interactively; to open it click the button to the right of the text box. When you click the OK button, the "Key Name" and "Value Name" fields will be filled, if you have selected the necessary value.
  3519.  
  3520. Value Name
  3521. Name of the value to be deleted.
  3522.  
  3523. Variable
  3524. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  3525.  
  3526.  
  3527.   Related Topics
  3528. Add key
  3529. Delete Key
  3530. Rename Key
  3531. Read Value
  3532. Write Value
  3533. Rename value
  3534. Export
  3535. Import
  3536.  
  3537.  
  3538. .topic 2040
  3539.  
  3540. Renames the specified value in the registry.
  3541.  
  3542. Key Name
  3543. Full path to the value you'd like to rename. You can use the dialog box to select the key and value interactively; to open it click the button to the right of the text box. When you click the OK button, the "Key Name" and "Value Name" fields will be filled, if you have selected the necessary value.
  3544.  
  3545. Value Name
  3546. Name of the value to be renamed.
  3547.  
  3548. New Value Name
  3549. New name that will be assigned to the specified value.
  3550.  
  3551. Variable
  3552. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  3553.  
  3554.  
  3555.   Related Topics
  3556. Add key
  3557. Delete Key
  3558. Rename Key
  3559. Read Value
  3560. Write Value
  3561. Delete value
  3562. Export
  3563. Import
  3564.  
  3565.  
  3566. .topic 2050
  3567.  
  3568. Exports the specified registry branch to the specified file. The saved file has a format compatible with the REGEDIT.EXE system utility. This operation is useful when you make a backup copy of some information or move settings to another computer. You can easily import the export file using REGEDIT or the Import action of RoboTask.
  3569.  
  3570. Registry Key
  3571. The key (branch) of the registry that should be exported to a file. You can use the dialog box to select the key interactively; to open it click the button to the right of the text box.
  3572.  
  3573. File Name
  3574. Name of the file where information should be exported.
  3575.  
  3576. File Format
  3577. Choose the export file format.
  3578. Registration file (current format) - current default format for the installed operating system. For Windows 2000 and higher the format is Unicode text.
  3579. Win9/NT4 Registration File - old format that provides compatibility with Windows 9x/NT4. This format has a structure of a regular text file.
  3580.  
  3581. Variable
  3582. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  3583.  
  3584.  
  3585.   Related Topics
  3586. Add key
  3587. Delete Key
  3588. Rename Key
  3589. Read Value
  3590. Write Value
  3591. Delete value
  3592. Rename value
  3593. Import
  3594.  
  3595.  
  3596. .topic 2060
  3597.  
  3598. Imports the export file to the registry. The export file should be prepared with the REGEDIT.EXE system utility or the Export action.
  3599.  
  3600. File Name.
  3601. Name of the file to be imported.
  3602.  
  3603. Variable
  3604. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  3605.  
  3606.  
  3607.   Related Topics
  3608. Add key
  3609. Delete Key
  3610. Rename Key
  3611. Read Value
  3612. Write Value
  3613. Delete value
  3614. Rename value
  3615. Export
  3616. Import
  3617.  
  3618.  
  3619. .topic 1930
  3620.  
  3621. Allows you to send a string to a copy of RoboTask on another computer. This action works together with the "Listener" triggering event. The Listener event receives the string and can start some task according to its settings. Thus, you can synchronize several copies of RoboTask working on the local area network of your office or via the Intranet/Internet.
  3622.  
  3623. For example, it may be a command to pack IIS log files on the server and send the packed file by e-mail.
  3624.  
  3625. Host Name or IP Address
  3626. Specify the Host Name or IP address of the computer where you need to send the command. The Host Name can be either similar to www.mydomain.com for the Internet or just the name of the necessary computer for the local area network.
  3627.  
  3628. Port
  3629. Specify the port the command should be sent to. By default, the "Listener" listens to port 5254. The port number can be changed to any other number (see Plugin settings).
  3630.  
  3631. Access Password
  3632. Specify the password for connecting to remote RoboTask. If the Listener on remote RoboTask is configured to work without a password, leave this field blank.
  3633.  
  3634. Command
  3635. Specify the string (command) that should be sent to remote RoboTask. It can be any string. The "Listener" triggering event on the remote computer will analyze the string.
  3636.  
  3637. Variable
  3638. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  3639.  
  3640.  
  3641.   Related Topics
  3642. Send Network Message
  3643. Network Plugin settings
  3644. Listener
  3645.  
  3646. .topic 1060
  3647.  
  3648. Sends a text message using a local network area (LAN) connection to the specified computer. For example, you can use this action to display a message every time you receive an e-mail from a special customer when you are logged into a different computer on your network and cannot check your e-mail.
  3649.  
  3650.  
  3651. Computer Name
  3652. Enter the name of the computer or domain name that the message should be sent to. When the "*" symbol (without quotes) is specified, the message is broadcast to every computer in the primary domain of the system.
  3653.  
  3654. Important
  3655. If the Windows Messenger service is not running on the target computer, the message will not be received.
  3656.  
  3657. Message Text
  3658. Specifies the text of the message to be sent.
  3659.  
  3660. Variable
  3661. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  3662.  
  3663.  
  3664.   Related Topics
  3665. Send Command
  3666. Network Plugin settings
  3667. Listener
  3668.  
  3669.  
  3670. .topic 1940
  3671.  
  3672. The settings of the Network plugin are related to the "Listener" triggering event and set the global parameters of the "Listener".
  3673.  
  3674. Listener port
  3675. Specify the port the "Listener" will listen to. The default is 5254, but it can be changed for any other available port.
  3676.  
  3677. To Change Listener Access Passwordà
  3678. To change the access password for the Listener, specify the old password and enter the new password twice. By default, the password is empty, i.e. the access is granted without a password.
  3679.  
  3680. Encryption Required
  3681. Select this checkbox if you want to encrypt information when it is transferred between the computers. An 128-bit asymmetric encryption key is used for that. The key is generated randomly for each session.
  3682.  
  3683. IP Filter
  3684. You can use this tab to configure filtering requests by IP addresses. By default, the Listener is available for all IP addresses.
  3685.  
  3686.   Related Topics
  3687. Send Command
  3688. Send Network Message
  3689. Listener
  3690.  
  3691.  
  3692. .topic 2070
  3693.  
  3694. Opens a connection with the POP3 server. This action should be performed before you perform the "POP3 Mail Loop", "POP3 Download Email" and "POP3 Delete Email" actions. There can be only one open connection with the POP3 server within a task. If you need to process several mail servers one by one, you should close the previous connection before opening the next one (see the "POP3 close" action).
  3695.  
  3696. Host
  3697. IP-address or Host Name of the POP3 server.
  3698.  
  3699. Port
  3700. Port of the POP3 server. By default it's 110.
  3701.  
  3702. User Name
  3703. Name of the mailbox user.
  3704.  
  3705. Password
  3706. User password.
  3707.  
  3708. Variable
  3709. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  3710.  
  3711.  
  3712.   Related Topics
  3713. POP3 Close
  3714. POP3 Mail Loop
  3715. POP3 Download Email
  3716. POP3 Delete Email
  3717. Parse Email
  3718. Check for Email
  3719. Send Email
  3720.  
  3721. .topic 2080
  3722.  
  3723. Closes the open connection with the POP3 server. It doesn't require any additional parameters. When a task is finished, the open server connection closes automatically.
  3724.  
  3725.   Related Topics
  3726. POP3 Open
  3727. POP3 Mail Loop
  3728. POP3 Download Email
  3729. POP3 Delete Email
  3730. Parse Email
  3731. Check for Email
  3732. Send Email
  3733.  
  3734.  
  3735. .topic 2090
  3736.  
  3737. Allows processing messages on the POP3 server one by one in a loop. This action also allows parsing main parameters of a message without downloading the complete message from the server. You can assign parameters of each message to a user variable and perform initial parse within a loop.
  3738.  
  3739. Order Number
  3740. This loop parameter is compulsory as the current order number of a message serves as its identifier on the POP3 server. The numbering of messages starts with 1. The variable that contains the number of a message should be used in the loop in "POP3 Download Email" and "POP3 Delete Email" actions.
  3741.  
  3742. Subject
  3743. Optional parameter. Allows saving the message subject to a variable and parsing it in the loop.
  3744.  
  3745. Sender (FROM)
  3746. Optional parameter. Allows saving the sender address to a variable and using it within the loop.
  3747.  
  3748. Receipt (TO)
  3749. Optional parameter. Allows saving the recipient address to a variable as a string and using it within the loop.
  3750.  
  3751. Carbon Copy (CC)
  3752. Optional parameter. Allows saving the address of the recipient (or recipients) of a message copy to a variable as a string and use it within the loop.
  3753.  
  3754. Message Size
  3755. Optional parameter. Allows saving the message size in bytes to a variable and using it within the loop.
  3756.  
  3757. Note:
  3758. Addresses in the message can be written in form of:
  3759. E-mail address only. For example:
  3760. john@yahoo.com
  3761. Recipient's name and address. For example:
  3762. John Smith <john@yahoo.com>
  3763. Several recipients separated with a semicolon. For example:
  3764. John Smith <john@yahoo.com>; Melissa Carver <melissa@hotmail.com>
  3765.  
  3766.  
  3767.   Related Topics
  3768. POP3 Open
  3769. POP3 Close
  3770. POP3 Download Email
  3771. POP3 Delete Email
  3772. Parse Email
  3773. Check for Email
  3774. Send Email
  3775.  
  3776.  
  3777. .topic 2100
  3778.  
  3779. Receives a message from the POP3 server and saves it to a file.
  3780.  
  3781. Order Number of Message
  3782. Order number of the current message. It can be generated in the "POP3 mail loop" using a variable or you can set it manually. If the message number is invalid, an "Invalid number of message" error will occur when the action is carried out.
  3783.  
  3784. Save Message to File
  3785. Specify the name of file where the message should be saved. You can use variables to generate the file name. By default, the
  3786. {TempDir}\{Year}{MonthNo}{Day}{Hours}{Minutes}{Seconds}{mSeconds}.eml
  3787. string is specified. It provides a unique name and makes it more convenient to sort files by the time when the message was received.
  3788.  
  3789. Extract Attachments to Folder
  3790. When you receive a message, you can extract all attachments to separate files. To do it, you should specify a folder where all attachments should be extracted.
  3791.  
  3792. If File Already Exists
  3793. Specify an action that should be performed if the application file already exists.
  3794. Rename - in this case a suffix with an order number will be added to the file name;
  3795. Overwrite - the file will be saved with the original name and the old file will be overwritten.
  3796.  
  3797. Variable
  3798. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  3799.  
  3800.  
  3801.   Related Topics
  3802. POP3 Open
  3803. POP3 Close
  3804. POP3 Mail Loop
  3805. POP3 Delete Email
  3806. Parse Email
  3807. Check for Email
  3808. Send Email
  3809.  
  3810.  
  3811. .topic 2110
  3812.  
  3813. Deletes the email message from the POP3 server.
  3814.  
  3815. Order Number of Message
  3816. Order number of the message to be deleted. It can be generated in the "POP3 mail loop" using a variable or you can set it manually. If the message number is invalid, a "No such message" error will occur when is action is carried out.
  3817.  
  3818. Variable
  3819. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  3820.  
  3821.  
  3822.   Related Topics
  3823. POP3 Open
  3824. POP3 Close
  3825. POP3 Mail Loop
  3826. POP3 Download Email
  3827. POP3 Delete Email
  3828. Parse Email
  3829. Check for Email
  3830. Send Email
  3831.  
  3832.  
  3833. .topic 2120
  3834.  
  3835. Parses message in the file. It separates the message into its main parts:
  3836. Message subject (the SUBJECT field);
  3837. Sender (the FROM field);
  3838. Recipient (the TO field);
  3839. Recipient of a copy (the CC field);
  3840. Message body (the text);
  3841. Attachments.
  3842.  
  3843. File Name
  3844. Specify the filename of the message you want to parse. Such files usually have EML extension.
  3845.  
  3846. General tab
  3847. Subject
  3848. Specify the name of variable where the message subject should be saved.
  3849.  
  3850. Sender (FROM)
  3851. Specify the name of variable where the sender's address should be saved.
  3852.  
  3853. Recipient (TO)
  3854. Specify the name of variable where the recipient's address should be saved. This field can contain several addresses separated with a comma or a semicolon.
  3855.  
  3856. Carbon Copy (CC)
  3857. Specify the name of variable where the address of the recipient of a copy should be saved. This field can contain several addresses separated with a comma or a semicolon.
  3858.  
  3859. Message Text tab
  3860.  
  3861. Assign Message Text to Variable
  3862. Specify the variable where the message body should be saved.
  3863.  
  3864. Prefer
  3865. Specify the format that should be preferred if the message body contains both message formats. The message body can contain the following formats:
  3866. Plain Text
  3867. HTML Text
  3868. If the message body contains one format only, this message text will be assigned to the variable no matter what value the Prefer parameter has.
  3869.  
  3870. Attachments tab
  3871. Extract Attachments to Folder
  3872. Specify the folder where all attachments should be extracted.
  3873.  
  3874. If File Already Exists
  3875. Specify an action that should be performed if the specified folder already contains a file with the application name.
  3876. Rename - in this case a suffix with an order number will be added to the file name;
  3877. Overwrite - the application will be saved with the original name and the existing file will be overwritten.
  3878.  
  3879. Variable
  3880. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  3881.  
  3882. Note:
  3883. Addresses in the message can be written in form of:
  3884. E-mail address only. For example:
  3885. john@yahoo.com
  3886. Recipient's name and address. For example:
  3887. John Smith <john@yahoo.com>
  3888. Several recipients separated with a semicolon. For example:
  3889. John Smith <john@yahoo.com>; Melissa Carver <melissa@hotmail.com>
  3890.  
  3891.   Related Topics
  3892. POP3 Open
  3893. POP3 Close
  3894. POP3 Mail Loop
  3895. POP3 Download Email
  3896. POP3 Delete Email
  3897. Parse Email
  3898. Check for Email
  3899. Send Email
  3900.  
  3901.  
  3902. .topic 1800
  3903.  
  3904. The Basic plugin is not included in the main installation package. You can download it additionally from http://www.robotask.com/downloads/.
  3905.  
  3906. .topic 1780
  3907.  
  3908. Allows you to make calculations using the functions of mathematical operations and BASIC functions. The result is assigned to a user variable.
  3909. This action is convenient when you need to make some small calculations without writing a Basic script.
  3910.  
  3911. Expression to Evaluate
  3912. Mathematical expression. The result can be of any type. For more details on expression syntax see description of BASIC language .
  3913.  
  3914. For example:
  3915.  
  3916. {TotalSize}/{FileCount}
  3917. Left(Right("{DateTime}",8),2)
  3918.  
  3919. Assign Result to Variable
  3920. Specify the variable the result should be assigned to.
  3921.  
  3922. Variable
  3923. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  3924.  
  3925.  
  3926. Test
  3927. Click this button to ensure that the parameters for the current action work.
  3928.  
  3929.  
  3930.   Related Topics
  3931. Basic script
  3932. Also see Basic help
  3933.  
  3934. .topic 1790
  3935.  
  3936. It is a universal tool allowing you to execute scripts written in BASIC. Scripts can be virtually as complicated as you need. You can use such a script to access the RoboTaskApp COM object allowing you to access service functions of RoboTask, as well as other tasks. The description of the RoboTaskApp object is given below.
  3937. See additional information about the BASIC language in the BASIC help.
  3938.  
  3939. Script source
  3940. You can select the script storage method
  3941.  
  3942. Internal - the script is stored in the task file in this case. This storage method is good for small scripts consisting of one or several procedures.
  3943. External Script - the script is stored in a separate file. This storage method is good for complex subroutines consisting of several modules (see the keyword "uses" or "include" in the Basic help).
  3944.  
  3945.   Related Topics
  3946. Evaluate
  3947. RoboTaskApp object
  3948. Also see Basic help
  3949.  
  3950.  
  3951. .topic 1960
  3952.  
  3953. There is no need to create the RoboTaskApp object when you are running or editing the script. It is created before you run the script and is available as a global object inside the script.
  3954.  
  3955. RoboTaskApp.AddUserVariable(By Val Name as String, By Val Value as String)
  3956. Creates a user variable with the specified "Name" and assign the specified "Value" to it.
  3957.  
  3958. RoboTaskApp.Automation
  3959. A Boolean attribute. It is available for reading and writing. It contains the value of the RoboTask automation mode.
  3960.  
  3961. RoboTaskApp.Close
  3962. Exits RoboTask.
  3963.  
  3964. RoboTaskApp.DelUserVariable(By Val Name as String)
  3965. Deletes the user variable with the specified "Name".
  3966.  
  3967. RoboTaskApp.ExpandText(By Val Text as String)
  3968. Expands a string containing RoboTask variables and returns the value of the string type.
  3969. For example: the string "File c:\autoexec.bat has length {FileSize(c:\autoexec.bat)} bytes" will be turned into the string "File c:\autoexec.bat has length 153 bytes"
  3970.  
  3971. RoboTaskApp.ExternalName(By Val ThreadID)
  3972. Returns the "External Name" of a task by its ThreadID. You can specify an External Name on the "Advanced" tab of the task editor. You can find out the ThreadID of the current task using the GetCurrentThreadId API function. A sample use is given below.
  3973.  
  3974. Declare Function GetCurrentThreadId Lib "kernel32" As Long
  3975.  
  3976. Sub Main
  3977.   Dim extName As String
  3978.   extName = RoboTaskApp.ExternalName(GetCurrentThreadId)
  3979.   MsgBox("External name is "+ extName)
  3980. End Sub
  3981.  
  3982. RoboTaskApp.Minimize
  3983. Minimizes RoboTask into the tray icon.
  3984.  
  3985. RoboTaskApp.Restore
  3986. Restores the RoboTask window from the tray icon.
  3987.  
  3988. RoboTaskApp.ServiceMode
  3989. The attribute is read-only. It contains a Boolean value: "True" if RoboTask is running as an NT service; "False" if RoboTask is running as a regular Windows application.
  3990.  
  3991. RoboTaskApp.SetUserVariable(By Val Name as String, By Val Value as String)
  3992. Sets the value of the "Name" user variable to the specified "Value"
  3993.  
  3994. RoboTaskApp.StartTask(By Val ExternalName as String)
  3995. Starts the task with the specified "External Name".
  3996.  
  3997. RoboTaskApp.StopTask(By Val ExternalName as String)
  3998. Stops the task with the specified "External Name".
  3999.  
  4000. RoboTaskApp.TaskCount
  4001. The read-only attribute of the numerical type. Returns the number of tasks registered in RoboTask.
  4002.  
  4003. RoboTaskApp.TaskEnabled(By Val ExternalName as String)
  4004. A Boolean attribute available for reading and writing. Allows you to read or set the "Enabled" parameter of the task with the specified "ExternalName".
  4005. For example:
  4006. RoboTaskApp.TaskEnabled("Check_email") = False
  4007.  
  4008. RoboTaskApp.TaskInfo(By Val NumTask as Long, ExtName as String, Name as String, ID as Long)
  4009. Sets the properties of the task with the specified number ("NumTask").
  4010. ExtName û External Name;
  4011. Name û task name;
  4012. ID û internal numerical identifier.
  4013. This method is used to enumerate all tasks and extract the parameter of each task. A sample use is given below.
  4014.  
  4015. Declare Function GetCurrentThreadId Lib "kernel32" As Long
  4016.  
  4017. Sub Main
  4018.     Dim cnt As Long
  4019.     Dim nam As String
  4020.     Dim extNam As String
  4021.     Dim id As Long
  4022.     Dim i As Long
  4023.  
  4024.     cnt = RoboTaskApp.TaskCount
  4025.     RoboTaskApp.WriteToLog(1,"Total "+Str(cnt)+" tasks",GetCurrentThreadId)
  4026.  
  4027.     For i  = 0 To cnt - 1
  4028.         RoboTaskApp.TaskInfo(i,extNam,nam,id)
  4029.         RoboTaskApp.WriteToLog(1,extNam+"; "+nam+"; "+Str(id),GetCurrentThreadId)
  4030.     Next
  4031. End Sub
  4032.  
  4033. RoboTaskApp.Version
  4034. A read-only attribute of the string type. Contains the version number of RoboTask in it.
  4035.  
  4036. RoboTaskApp.WHandle
  4037. A read-only attribute of the Long type. Contains the Handle of the main RoboTask window. This value is necessary for some Windows API functions to work properly (for example, SendMessage, PostMessage).
  4038.  
  4039. RoboTaskApp.WriteToLog(By Val MsgType as Integer, By Val MessageStr as String, By Val ThreadID as Long)
  4040. Records a message to the task log. To record a message to the system log of RoboTask, you should set the TreadID to 0.
  4041. MsgType û message type: 0 û regular message, 1 û warning, 2 û error;
  4042. MessageStr û message string
  4043. ThreadID û the Thread ID of the current task. It can be obtained using the GetCurrentThreadId API function. If you set it to 0, the message will be recorded to the system log of RoboTask.
  4044. A sample use is given below.
  4045.  
  4046. Declare Function GetCurrentThreadId Lib "kernel32" As Long
  4047.  
  4048. Sub Main
  4049.   Dim thr As Long
  4050.   thr = GetCurrentThreadId
  4051.   RoboTaskApp.WriteToLog(1, "Hello World", thr)
  4052. End Sub
  4053.  
  4054.  
  4055.   Related Topics
  4056. Evaluate
  4057. Basic script
  4058. Also see Basic help
  4059.  
  4060.  
  4061.  
  4062. .topic 1970
  4063.  
  4064. The CD/DVD Writer plugin is not included in the main installation package. You can download it additionally from http://www.robotask.com/downloads/.
  4065.  
  4066.  
  4067. .topic 1870
  4068.  
  4069. Allows you to write files to a CD/DVD. This operation is very useful for automating backup processes.
  4070.  
  4071. General tab
  4072.  
  4073. Select Device
  4074. Use the list to select the device files will be written to.
  4075.  
  4076. Destination Folder
  4077. Specify the folder to write files to. You can use RoboTask variables. For example, it can be useful for backups if you specify the folder name based on the current date: \{YEAR}{MONTHNO}{DAY}
  4078.  
  4079. Files to Write
  4080. Fill the list of files using the corresponding buttons. You can also fill it by dragging the necessary files and folders from a Windows Explorer window.
  4081.  
  4082. If File Exists
  4083. Specify what to do if the files being written already exist on the disk.
  4084.  
  4085. Write Options tab
  4086.  
  4087. Volume Name
  4088. The name of the disk being burned. You can specify the name explicitly or inherit the name from the imported session.
  4089.  
  4090. Write speed
  4091. Use the list to select the necessary record speed.
  4092.  
  4093. Allow Joliet File Names
  4094. Select this checkbox if you want to enable long file names.
  4095.  
  4096. Finalize Disk
  4097. Specify if it is necessary to finalize the disk. The disk will become read-only if it is finalized.
  4098.  
  4099. Use Buffer Protection
  4100. Buffer protection. It is recommended to enable this option in order to ensure that the disk is burnt continuously in case of possible problems with reading the source files.
  4101.  
  4102. For CD-R/CD-RW only
  4103. Specify the writing mode and whether it is necessary to cache information before writing it to the disk. These parameters make sense only when data is written to a ╤D-R/CD-RW and will be ignored when writing data to a DVD.
  4104.  
  4105. For DVD only
  4106. If it is known beforehand that the amount of the information is certainly more than 1 GB, you can enable the DVD High Compatibility option.
  4107.  
  4108. Variable
  4109. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  4110.  
  4111.  
  4112.   Related Topics
  4113. Erase Disk
  4114. Eject/Load CD Tray
  4115.  
  4116. .topic 1880
  4117.  
  4118. Allows you to erase the entire information from a CD/DVD RW.
  4119.  
  4120. Device
  4121. Select a device.
  4122.  
  4123. Erase Mode
  4124. Quick Erase and Full Erase modes.
  4125. If you use the Quick Erase mode, only the logical structure will be deleted without physically erasing the information from the disk. That is why the operation takes 1-1.5 minutes and the disk is considered empty and becomes available for writing.
  4126. In case with the Full Erase mode, the entire information is physically erased from the disk. Depending on the drive and disk, such an operation may take 20 minutes or longer. This operation ensures that it will be impossible to restore any data from the disk.
  4127.  
  4128. Eject After Complete
  4129. Select this checkbox if you want the drive to eject its tray after erasing is over.
  4130.  
  4131.   Related Topics
  4132. Write to disk
  4133. Eject/Load CD Tray
  4134.  
  4135.  
  4136. .topic 1890
  4137.  
  4138. Allows you to eject or load the tray of the CD drive.
  4139.  
  4140. Device
  4141. Select a device.
  4142.  
  4143. Action
  4144. Select whether to eject or load the tray of the CD drive.
  4145.  
  4146.   Related Topics
  4147. Write to disk
  4148. Erase Disk
  4149.  
  4150.  
  4151. .topic 1290
  4152.  
  4153. Executes a task at a given time or interval. For example, you can use this triggering event to ensure your backup runs every day at midnight.
  4154.  
  4155.  
  4156. Add This Time ___
  4157. Enter a time to execute the action and then click the Plus button to add the time to the list.
  4158.  
  4159. Time List
  4160. Displays a list of times that you add with the Plus button.
  4161. The Magnifier button displays the Add Time Wizard.
  4162.  
  4163.  
  4164. To remove a time, select a time in the Time List and click the Minus button. To clear the list, click the X button.
  4165.  
  4166. Time Period
  4167. Enter whether you want the action to start every day, week, or month.
  4168.  
  4169. Start
  4170. Select the date that you want the event starts to execute a task.
  4171.  
  4172.   Related Topics
  4173. Hot Keys    
  4174. Tray Icon    
  4175. Cyclic
  4176. File Monitor    
  4177. Dial-Up Connection Monitor
  4178. Window Watcher
  4179. On Time Changed
  4180. On Battery Power is Low
  4181. On Spooler Changed
  4182. On Device Changed
  4183. On Palette Changed
  4184. On Display Changed
  4185. On Log Off
  4186. On Idle
  4187. Listener
  4188.  
  4189.  
  4190.  
  4191. .topic 1300
  4192.  
  4193. Executes a task that should be started manually. You can set up a combination of hot keys, such as CTRL + ALT + F. For example, you could set up a combination of hot keys to start Internet Explorer from your keyboard every time you want to browse the Internet.
  4194.  
  4195. Tip
  4196. The Tray Icon triggering event also allows you start processes manually.
  4197.  
  4198. Hot Keys
  4199. Place your cursor in the box and press the keys you want on the keyboard. For example, press the ALT key to see "Alt" appear in the box.
  4200.  
  4201.   Related Topics
  4202. Scheduler
  4203. Tray Icon    
  4204. Cyclic
  4205. File Monitor    
  4206. Dial-Up Connection Monitor
  4207. Window Watcher
  4208. On Time Changed
  4209. On Battery Power is Low
  4210. On Spooler Changed
  4211. On Device Changed
  4212. On Palette Changed
  4213. On Display Changed
  4214. On Log Off
  4215. On Idle
  4216. Listener
  4217.  
  4218.  
  4219.  
  4220. .topic 1310
  4221.  
  4222. Executes a task when you double-click a specific icon in the system tray of the Windows Taskbar. This is useful when you want a specific action to start, such as checking e-mail.
  4223.  
  4224. Tip
  4225. The Tray Icon triggering event also allows you start processes manually.
  4226.  
  4227.  
  4228. File Name
  4229. Enter the name and path of an .Exe or .Dll file to select an icon from. You can click the browse button to select a file.
  4230.  
  4231. Current Icon
  4232. Displays icons available from the file that you select in the File Name box.
  4233.  
  4234. Variable
  4235. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  4236.  
  4237.  
  4238.   Related Topics
  4239. Scheduler
  4240. Hot Keys    
  4241. Cyclic
  4242. File Monitor    
  4243. Dial-Up Connection Monitor
  4244. Window Watcher
  4245. On Time Changed
  4246. On Battery Power is Low
  4247. On Spooler Changed
  4248. On Device Changed
  4249. On Palette Changed
  4250. On Display Changed
  4251. On Log Off
  4252. On Idle
  4253. Listener
  4254.  
  4255.  
  4256. .topic 1360
  4257.  
  4258. Executes a task at the interval in seconds that you specify. This is useful if you want to repeat a series of actions at a specific interval. For example, you can ping your web site every two minutes or check for new e-mails every five minutes.
  4259.  
  4260.  
  4261. Interval (Sec)
  4262. Enter the number of seconds that you want the task or actions to wait between loops.
  4263.  
  4264.   Related Topics
  4265. Scheduler
  4266. Hot Keys    
  4267. Tray Icon    
  4268. File Monitor    
  4269. Dial-Up Connection Monitor
  4270. Window Watcher
  4271. On Time Changed
  4272. On Battery Power is Low
  4273. On Spooler Changed
  4274. On Device Changed
  4275. On Palette Changed
  4276. On Display Changed
  4277. On Log Off
  4278. On Idle
  4279. Listener
  4280.  
  4281.  
  4282. .topic 1320
  4283.  
  4284. Executes a task when a file is created, deleted, or changed.
  4285.  
  4286. General tab
  4287. Save Changes tab
  4288.  
  4289. #General tab
  4290.  
  4291.  
  4292. Folders
  4293. Select the folders that are monitored. Each folder can be monitored with subfolders. When you click the Plus button, the Add Folder for Watch dialog box appears.
  4294.  
  4295.  
  4296. Include Masks (Comma Separated)
  4297. Enter one or more masks separated with commas. The wildcard mask "*.*" means that all files are being monitored.
  4298.  
  4299. Exclude Masks (Comma Separated)
  4300. Specify one or more masks for the kinds of files that you do not want to monitor. Separate each entry with a comma. Files that match these criteria do not appear on the result list.
  4301.  
  4302.  
  4303.  
  4304.  
  4305. Filter Condition
  4306. Select one or more check boxes to specify which changes in files you want to monitor:
  4307. Watch for New Files
  4308. Watch for Deleted Files
  4309. Watch for Changed Files
  4310. Time Changed
  4311. Size Changed
  4312. Attributes Changed
  4313.  
  4314. Poll Interval (Sec)
  4315. Enter the time in seconds that you want the event to wait between requests for data.
  4316.  
  4317. Variable
  4318. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  4319.  
  4320.  
  4321. #Save Changes tab    
  4322.  
  4323.  
  4324. Save Changes
  4325. Click the check box to enable the task to save changes to files during the file monitoring session in a log.
  4326.  
  4327. Save in Common List
  4328. Enter the name of a log file that includes all changes during the file monitoring session. Click the browse button to select a file on the local system.
  4329.  
  4330. List File Name
  4331. Enter the file name of the log. Click the browse button to select a file on the local system.
  4332.  
  4333. Save in Different Lists
  4334. Click the check box to enable the task to save changes to file during the file monitoring session to several different logs based on the criteria you select.
  4335.  
  4336. Tip
  4337. You can click a browse button next to each of the following options to select a file on the local system.
  4338.  
  4339. List File Name (for New Files)
  4340. Saves a log of the names of files created during the monitoring session.
  4341.  
  4342. List File Name (For Deleted Files)
  4343. Saves a log of the names of files deleted during the monitoring session.
  4344.  
  4345. List File Name (For Changed Files)
  4346. Saves a log of the names of the files modified during the monitoring session.
  4347.  
  4348. Variable
  4349. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  4350.  
  4351.  
  4352.   Related Topics
  4353. Scheduler
  4354. Hot Keys    
  4355. Tray Icon    
  4356. Cyclic
  4357. Dial-Up Connection Monitor
  4358. Window Watcher
  4359. On Time Changed
  4360. On Battery Power is Low
  4361. On Spooler Changed
  4362. On Device Changed
  4363. On Palette Changed
  4364. On Display Changed
  4365. On Log Off
  4366. On Idle
  4367. Listener
  4368.  
  4369.  
  4370.  
  4371. .topic 610
  4372.  
  4373. Executes a task when the computer completes or terminates a specific dial-up connection. You can specify that RoboTask check for a connection at a specific interval; for example, you can specify that RoboTask check for a dial-up connection every 300 seconds, or every five minutes.
  4374.  
  4375.  
  4376. Dial-up Connection
  4377. Select a connection in the dropdown list. The items on the list are the names of the Internet connections for dial-up modems that you create in Windows with Network Connections in the Control Panel.
  4378.  
  4379. Interval (sec)
  4380. Enter the number of seconds that you want the task to wait between checks.
  4381.  
  4382. What to Check
  4383. Click one of the following options to tell the task to check if the connection is active or disconnected:
  4384.  
  4385. Disconnect
  4386. Connect
  4387.  
  4388.   Related Topics
  4389. Scheduler
  4390. Hot Keys    
  4391. Tray Icon    
  4392. Cyclic
  4393. File Monitor    
  4394. Window Watcher
  4395. On Time Changed
  4396. On Battery Power is Low
  4397. On Spooler Changed
  4398. On Device Changed
  4399. On Palette Changed
  4400. On Display Changed
  4401. On Log Off
  4402. On Idle
  4403. Listener
  4404.  
  4405.  
  4406.  
  4407. .topic 620
  4408.  
  4409. Runs the task when you perform some actions with windows. This task can respond to creation, destruction, activation and deactivation of a window with specified parameters. Such task can be useful if you want to introduce automatic corrective actions that respond to an error message.
  4410.  
  4411. General
  4412. Window Caption
  4413. Specify the window title that should be traced. You can specify a specific part of the title if it shouldn't match completely. For example:
  4414. - Microsoft Internet Explorer
  4415. Notepad
  4416. You can select a title from the list of windows present in the system by clicking the button to the right of the text box. When captions are compared, the case is not taken into account.
  4417.  
  4418. Caption must match exactly
  4419. Select this checkbox if the caption should match exactly. In this case you should specify the full window title.
  4420.  
  4421. Window class
  4422. Specify the window class that should be traced. You can select a window class from the list of classes present in the system by clicking the button on the right of the text box.
  4423. When strings are compared, the case is not taken into account.
  4424.  
  4425. Class must match exactly
  4426. Select this checkbox if the window class string should match exactly.
  4427.  
  4428. Advanced
  4429. Watch hidden windows
  4430. Select this checkbox if you want the event to trace hidden windows.
  4431.  
  4432. Watch child windows
  4433. Select this checkbox if you want the event to trace child windows.
  4434.  
  4435. Assign window handle to variable
  4436. If you want to save Window Handle for further processing in the task, specify the name of the variable. Window Handle is a unique numeric identifier of a window in the system. It can be used in the Window Command action.
  4437.  
  4438. Watch For
  4439. Click one of the following window states:
  4440.  
  4441. Window Activated  - the event is triggered when a new or existing window is activated. For example, a window activates when a user presses ALT+Tab on the keyboard.
  4442. Window Destroyed - the event is triggered when the window is closed.
  4443. Window Created - the event is triggered when a new window is created.
  4444. Window Deactivated - the event is triggered when a new or existing window is deactivated. For example, a window deactivates when a user presses ALT+Tab on the keyboard.
  4445.  
  4446. Variable
  4447. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  4448.  
  4449.  
  4450.   Related Topics
  4451. Scheduler
  4452. Hot Keys    
  4453. Tray Icon    
  4454. Cyclic
  4455. File Monitor    
  4456. Dial-Up Connection Monitor
  4457. On Time Changed
  4458. On Battery Power is Low
  4459. On Spooler Changed
  4460. On Device Changed
  4461. On Palette Changed
  4462. On Display Changed
  4463. On Log Off
  4464. On Idle
  4465. Listener
  4466.  
  4467. .topic 630
  4468.  
  4469. Executes a task when the computer system time changes. No specific settings are associated with this triggering event.
  4470.  
  4471.   Related Topics
  4472. Scheduler
  4473. Hot Keys    
  4474. Tray Icon    
  4475. Cyclic
  4476. File Monitor    
  4477. Dial-Up Connection Monitor
  4478. Window Watcher
  4479. On Battery Power is Low
  4480. On Spooler Changed
  4481. On Device Changed
  4482. On Palette Changed
  4483. On Display Changed
  4484. On Log Off
  4485. On Idle
  4486. Listener
  4487.  
  4488.  
  4489.  
  4490. .topic 640
  4491.  
  4492. Executes a task when the computer battery is low on power. For example, you can use this triggering event to fire a message that displays on the screen, telling you to replace the computer battery on your laptop computer. No specific settings are associated with this triggering event.
  4493.  
  4494.   Related Topics
  4495. Scheduler
  4496. Hot Keys    
  4497. Tray Icon    
  4498. Cyclic
  4499. File Monitor    
  4500. Dial-Up Connection Monitor
  4501. Window Watcher
  4502. On Time Changed
  4503. On Spooler Changed
  4504. On Device Changed
  4505. On Palette Changed
  4506. On Display Changed
  4507. On Log Off
  4508. On Idle
  4509. Listener
  4510.  
  4511.  
  4512. .topic 650
  4513.  
  4514. Executes a task when the printer spooler has changed. For example, you can use this triggering event to display a message if a particular document is sent to a printer. No specific settings are associated with this triggering event.
  4515.  
  4516.   Related Topics
  4517. Scheduler
  4518. Hot Keys    
  4519. Tray Icon    
  4520. Cyclic
  4521. File Monitor    
  4522. Dial-Up Connection Monitor
  4523. Window Watcher
  4524. On Time Changed
  4525. On Battery Power is Low
  4526. On Device Changed
  4527. On Palette Changed
  4528. On Display Changed
  4529. On Log Off
  4530. On Idle
  4531. Listener
  4532.  
  4533.  
  4534. .topic 660
  4535.  
  4536. Runs the task when a device (for example, CD or Flash Drive) is changed. The device name can be saved to a variable and used in the task.
  4537.  
  4538. Device Kind
  4539. Specify a type of device that triggers the task.
  4540. All (Logical Volume & Port) - any type of device;
  4541. Logical Volume - a logical volume mounted dynamically (CD, Flash Drive, etc.);
  4542. Port - a COM or LPT port.
  4543.  
  4544. Change Kind
  4545. Specify a type of change that triggers the task.
  4546. All (Arrival & Remove) - any type of event;
  4547. Arrival - a device (drive) appears in the system. For example, you have inserted a new CD;
  4548. Remove - a device is removed from the system. For example, you have pressed the eject button of the CD drive.
  4549.  
  4550. Assign Device Name to Variable
  4551. Specify a name of variable where you want to save the name of the device that has been changed.
  4552.  
  4553.   Related Topics
  4554. Scheduler
  4555. Hot Keys    
  4556. Tray Icon    
  4557. Cyclic
  4558. File Monitor    
  4559. Dial-Up Connection Monitor
  4560. Window Watcher
  4561. On Time Changed
  4562. On Battery Power is Low
  4563. On Spooler Changed
  4564. On Palette Changed
  4565. On Display Changed
  4566. On Log Off
  4567. On Idle
  4568. Listener
  4569.  
  4570.  
  4571. .topic 670
  4572.  
  4573. Executes a task when the display palette, or colors on the computer screen, for Windows changes. This can happen when you switch between an MS-DOS application and a Windows-based application. No specific settings are associated with this triggering event.
  4574.  
  4575.   Related Topics
  4576. Scheduler
  4577. Hot Keys    
  4578. Tray Icon    
  4579. Cyclic
  4580. File Monitor    
  4581. Dial-Up Connection Monitor
  4582. Window Watcher
  4583. On Time Changed
  4584. On Battery Power is Low
  4585. On Spooler Changed
  4586. On Device Changed
  4587. On Display Changed
  4588. On Log Off
  4589. On Idle
  4590. Listener
  4591.  
  4592.  
  4593.  
  4594. .topic 680
  4595.  
  4596. Executes a task when the display on the computer screen changes. No specific settings are associated with this triggering event.
  4597.  
  4598.   Related Topics
  4599. Scheduler
  4600. Hot Keys    
  4601. Tray Icon    
  4602. Cyclic
  4603. File Monitor    
  4604. Dial-Up Connection Monitor
  4605. Window Watcher
  4606. On Time Changed
  4607. On Battery Power is Low
  4608. On Spooler Changed
  4609. On Device Changed
  4610. On Palette Changed
  4611. On Log Off
  4612. On Idle
  4613. Listener
  4614.  
  4615.  
  4616. .topic 1330
  4617.  
  4618. Executes a task when a user logs off or the computer shuts down. No specific settings are associated with this triggering event.
  4619.  
  4620.   Related Topics
  4621. Scheduler
  4622. Hot Keys    
  4623. Tray Icon    
  4624. Cyclic
  4625. File Monitor    
  4626. Dial-Up Connection Monitor
  4627. Window Watcher
  4628. On Time Changed
  4629. On Battery Power is Low
  4630. On Spooler Changed
  4631. On Device Changed
  4632. On Palette Changed
  4633. On Display Changed
  4634. On Idle
  4635. Listener
  4636.  
  4637.  
  4638. .topic 690
  4639.  
  4640. Executes a task when the computer has been idle for a specified period of time.
  4641.  
  4642.  
  4643. Run Job When Computer Has Been Idle for ___ Minutes
  4644.  
  4645. Enter the time that you want in minutes.
  4646.  
  4647.   Related Topics
  4648. Scheduler
  4649. Hot Keys    
  4650. Tray Icon    
  4651. Cyclic
  4652. File Monitor    
  4653. Dial-Up Connection Monitor
  4654. Window Watcher
  4655. On Time Changed
  4656. On Battery Power is Low
  4657. On Spooler Changed
  4658. On Device Changed
  4659. On Palette Changed
  4660. On Display Changed
  4661. On Log Off
  4662. Listener
  4663.  
  4664.  
  4665.  
  4666.  
  4667. .topic 1950
  4668.  
  4669. Allows you to start a task when a command from another computer is received. Works together with the Send Command action. Performs the primary analysis of the received string and starts the corresponding task if the received string meets the specified conditions.
  4670.  
  4671. Wait For Option
  4672. Select the mode of waiting for a string.
  4673.  
  4674. Any string - any received string will start the task. For example, it is convenient if you exchange messages that should be just recorded to the log.
  4675. Beginning of String - the received string should start with the key substring.
  4676. Substring - the key substring can be in any position of the received string.
  4677. Exact String - the received string must exactly match the key string.
  4678.  
  4679. Wait for String
  4680. Specify the key string that will start the task. This parameter does not make sense if the "Any String" mode is on.
  4681.  
  4682. Case Sensitive
  4683. Select this checkbox if strings should be compared with their letter case taken into account.
  4684.  
  4685. Assign Received String to Variable
  4686. Specify the name of the variable if the received string should be assigned to a variable. This value can be used in the task.
  4687.  
  4688. The simplest sample use is message exchange: the Listener receives a string, assigns it to a variable and starts the task. The task displays this variable as an informational message.
  4689.  
  4690. Plugin settings
  4691. You can set up parameters of Network plugin.
  4692.  
  4693. Variable
  4694. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  4695.  
  4696.  
  4697.   Related Topics
  4698. Scheduler
  4699. Hot Keys    
  4700. Tray Icon    
  4701. Cyclic
  4702. File Monitor    
  4703. Dial-Up Connection Monitor
  4704. Window Watcher
  4705. On Time Changed
  4706. On Battery Power is Low
  4707. On Spooler Changed
  4708. On Device Changed
  4709. On Palette Changed
  4710. On Display Changed
  4711. On Log Off
  4712. Listener
  4713. Network Plugin settings
  4714.  
  4715. .topic 2150
  4716.  
  4717.  
  4718.  
  4719.  
  4720. .topic 1370
  4721. Variable
  4722. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  4723.  
  4724. .topic 1400
  4725. Test
  4726. Click this button to ensure that the parameters for the current action work.
  4727.  
  4728. .topic 1410
  4729.  
  4730.  
  4731. .topic 1630
  4732.  
  4733.  
  4734. .topic 1390
  4735. Add Folder for Watch Dialog Box
  4736.  
  4737. Folder Name
  4738. Enter the name of the folder that you want the task to monitor. Click the browse button to select folders on the local or remote computer.
  4739.  
  4740. Watch Subfolders
  4741. Click the check box to ensure the task monitors subfolders of the folder that you selected in the Folder Name box.
  4742.  
  4743. Variable
  4744. Allows you to add a variable to the action or triggering event that you selected. You must place the cursor in a edit box in the settings dialog window of the action or event and then click the {V} button.
  4745.  
  4746. .topic 1440
  4747. New Task
  4748.  
  4749. Allows you to add a new task. You can select actions and triggering events.
  4750.  
  4751.  
  4752. .topic 1450
  4753. Edit Task
  4754.  
  4755. Allows you to modify a task. You can edit the settings for actions and triggering events.
  4756.  
  4757. .topic 1460
  4758. Delete Task
  4759.  
  4760. Removes the task that you select in the main window.
  4761.  
  4762. .topic 1470
  4763. Run Task
  4764.  
  4765. Starts the task that you select in the main window.
  4766.  
  4767. .topic 1480
  4768. Stop Task
  4769.  
  4770. Stops the task that you select in the main window.
  4771.  
  4772. .topic 1490
  4773. Show/Hide Task Tree
  4774.  
  4775. Displays or hides the task tree at the left of the main window.
  4776.  
  4777. .topic 1500
  4778. Settings
  4779.  
  4780. Allows you to set preferences for RoboTask.
  4781.  
  4782. .topic 1510
  4783. New Folder
  4784.  
  4785. Allows you to create a new folder and enter the name.
  4786.  
  4787. .topic 2130
  4788. Note:
  4789. Addresses in the message can be written in form of:
  4790. E-mail address only. For example:
  4791. john@yahoo.com
  4792. Recipient's name and address. For example:
  4793. John Smith <john@yahoo.com>
  4794. Several recipients separated with a semicolon. For example:
  4795. John Smith <john@yahoo.com>; Melissa Carver <melissa@hotmail.com>
  4796.  
  4797. .topic 1590
  4798. Rename Folder
  4799.  
  4800. Allows you to rename the selected task folder.
  4801.  
  4802. .topic 1520
  4803. Remove Folder
  4804.  
  4805. Removes the task folder that you select.
  4806.  
  4807. .topic 1530
  4808. Expand All
  4809.  
  4810. Displays all the folders in the tree.
  4811.  
  4812. .topic 1540
  4813. Expand All
  4814.  
  4815. Hides the folders in the tree and displays only the top level folder.
  4816.  
  4817. .topic 1550
  4818. Folder Pane
  4819.  
  4820. Displays a tree of the task folders. This is useful for organizing your tasks.
  4821.  
  4822. .topic 1560
  4823. Task Name Column
  4824.  
  4825. Displays the name of the task.
  4826.  
  4827. .topic 1570
  4828. Status Column
  4829.  
  4830. Displays whether the task is enabled or disabled. You must run the task manually if the task is disabled by double-clicking it. You can change the status of a task: select the task and right-click.
  4831.  
  4832. .topic 1580
  4833. Log Pane
  4834.  
  4835. Displays the log messages when you open RoboTask or when a task runs. You can set options for the log when you add a task or edit one on the Advanced tab of the Add Task dialog box.
  4836.  
  4837. .topic 1600
  4838.         
  4839. Quick Start Guide        
  4840. Features
  4841. Getting Started in the RoboTask Window    
  4842. Create Tasks
  4843. Run Tasks    
  4844. Edit Tasks    
  4845. Customize RoboTask    
  4846. Purchasing    
  4847. License Agreement
  4848. Trademarks and Copyrights    
  4849. Using Variables in Tasks        
  4850. Using Variables    
  4851. Create a Variable    
  4852. Add Variables to a Task
  4853. Menus    Menus    
  4854. Task > New    
  4855. Task > Edit    
  4856. Task > Delete        
  4857. Task > Run    
  4858. Task > Stop    
  4859. Task > Duplicate    
  4860. Task > Create Shortcut on Desktop    
  4861. Task > Exit    
  4862. Options > View Log    
  4863. Options > View Toolbar    
  4864. Options > Settings
  4865. Options > Variables    
  4866. Tools > Enable Automation    
  4867. Tools > Enable All Tasks in List    
  4868. Tools > Disable All Tasks in List    
  4869. Help > Help Topics        
  4870. Help > Send Bug Report    
  4871. Help > About    
  4872. Actions        
  4873. General        
  4874. Run Program/Open Document    
  4875. Print Document        
  4876. Send Network Message    
  4877. Send Keystrokes    
  4878. Pause    
  4879. Log Off    
  4880. Dialog Boxes        
  4881. Show Message/Play Sound
  4882. Question Dialog    
  4883. Open Dialog
  4884. Save Dialog
  4885. Browse for Folders
  4886. Browse for Computers
  4887. Files and Folders        
  4888. Copy/Move File    
  4889. Rename File    
  4890. Delete File
  4891. Write Text File
  4892. Search for Files    
  4893. Change Folder    
  4894. Create Folder    
  4895. Rename Folder        
  4896. Remove Folder        
  4897. Synchronize Folders    
  4898. Zip        
  4899. Pack Files    
  4900. Extract Files    
  4901. Internet        
  4902. Check for Email
  4903. Send Email    
  4904. Download Files
  4905. Ping Host    
  4906. FTP        
  4907. FTP Log On        
  4908. FTP Log Off    
  4909. FTP Download        
  4910. FTP Upload    
  4911. FTP Rename File    
  4912. FTP Delete File    
  4913. FTP Change Folder    
  4914. FTP Create Folder    
  4915. FTP Remove Folderr    
  4916. FTP PWD    
  4917. FTP Transfer Type    
  4918. FTP Command
  4919. FTP File Loop    
  4920. Dial-Up        
  4921. Dial Up/Hang Up    
  4922. Variables        
  4923. Create Variable
  4924. Set Variable    
  4925. Remove Variable    
  4926. Task Commands        
  4927. Enable Task
  4928. Disable Task    
  4929. Start Task    
  4930. Loops and Flows        
  4931. File Loop    
  4932. Text Loop    
  4933. Dataset Loop    
  4934. Simple Loop    
  4935. End Loop    
  4936. Break    
  4937. Continue    
  4938. If Then        
  4939. Else    
  4940. End If
  4941. Window        
  4942. Window Command    
  4943. Check for Window
  4944. For Windows NT        
  4945. Start Service
  4946. Stop Service        
  4947. Lock Workstation        
  4948. RoboTask Commands        
  4949. Minimize RoboTask    
  4950. Restore RoboTask    
  4951. Exit RoboTask
  4952. Enable Automation    
  4953. Disable Automation    
  4954. Log Message
  4955.  
  4956.  
  4957. triggering actions
  4958.  
  4959.  
  4960.